# Shared

## Domain Types

### API Error

- `APIError`

  A direct mapping of tonic::Status, for use in HTTP responses.

  - `code: number`

    The error code is used to identify the nature of the error. It corresponds
    to an HTTP status code.

  - `message: string`

    A human-readable message providing more details about the error.

  - `details?: Array<Record<string, unknown>>`

    Additional error details, if any. This can include structured information
    such as field violations or error metadata.

### Base Response

- `BaseResponse`

  - `metadata: ResponseMetadata`

    Response metadata, including the request ID and optional pagination info.

    - `request_id: string`

      A unique ID for this request, generated upon ingestion of the request.

    - `next_page_token?: string | null`

      Base64URL-encoded pagination token containing limit and offset

    - `page_number?: number | null`

      Pagination. Included if this was a GET (list) response

    - `previous_page_token?: string | null`

      Base64URL-encoded pagination token containing limit and offset

    - `total_items?: number | null`

      Total number of items available (not just in this page).

    - `total_pages?: number | null`

      Total number of pages available.

  - `error?: APIError | null`

    Structured error details when the request is unsuccessful.

    - `code: number`

      The error code is used to identify the nature of the error. It corresponds
      to an HTTP status code.

    - `message: string`

      A human-readable message providing more details about the error.

    - `details?: Array<Record<string, unknown>>`

      Additional error details, if any. This can include structured information
      such as field violations or error metadata.

### Response Metadata

- `ResponseMetadata`

  Metadata for the response. This will always contain a request ID which can be used to identify
  the request to Clear Street for tracing, and optionally may include pagination data.

  - `request_id: string`

    A unique ID for this request, generated upon ingestion of the request.

  - `next_page_token?: string | null`

    Base64URL-encoded pagination token containing limit and offset

  - `page_number?: number | null`

    Pagination. Included if this was a GET (list) response

  - `previous_page_token?: string | null`

    Base64URL-encoded pagination token containing limit and offset

  - `total_items?: number | null`

    Total number of items available (not just in this page).

  - `total_pages?: number | null`

    Total number of pages available.