> ## Documentation Index
> Fetch the complete documentation index at: https://developers.circle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List attestations for crosschain transfers

> Returns an array of attestations for the specified crosschain transfers, filtered by remote domain.

Use the Link header in the response to navigate between pages.




## OpenAPI

````yaml openapi/xreserve.yaml get /v1/remote-domains/{remoteDomain}/attestations
openapi: 3.0.2
info:
  title: Circle xReserve
  version: 1.0.0
  description: >
    xReserve enables transfers between USDC and USDC-backed tokens across
    supported blockchain networks using a secure attestation system.
servers:
  - url: https://xreserve-api-testnet.circle.com
    description: Testnet
  - url: https://xreserve-api.circle.com
    description: Mainnet
security: []
tags:
  - name: xReserve
    description: xReserve endpoints
paths:
  /v1/remote-domains/{remoteDomain}/attestations:
    get:
      tags:
        - xReserve
      summary: List attestations for crosschain transfers
      description: >
        Returns an array of attestations for the specified crosschain transfers,
        filtered by remote domain.


        Use the Link header in the response to navigate between pages.
      operationId: listAttestations
      parameters:
        - $ref: '#/components/parameters/RemoteDomain'
        - $ref: '#/components/parameters/PageSize'
        - $ref: '#/components/parameters/PageAfter'
        - $ref: '#/components/parameters/PageBefore'
        - $ref: '#/components/parameters/From'
        - $ref: '#/components/parameters/To'
      responses:
        '200':
          $ref: '#/components/responses/AttestationsListResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '404':
          $ref: '#/components/responses/ErrorResponse'
        '500':
          $ref: '#/components/responses/ErrorResponse'
components:
  parameters:
    RemoteDomain:
      in: path
      name: remoteDomain
      required: true
      schema:
        type: integer
        minimum: 0
      description: The remote domain ID by which to filter results.
      example: 1
    PageSize:
      in: query
      name: pageSize
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 1000
      description: The number of results to return per page.
      example: 50
    PageAfter:
      in: query
      name: pageAfter
      required: false
      schema:
        type: string
      description: >-
        Base64-encoded pagination cursor that returns the next page of results.
        Do not use with `pageBefore`.
    PageBefore:
      in: query
      name: pageBefore
      required: false
      schema:
        type: string
      description: >-
        Base64-encoded pagination cursor that returns the previous page of
        results. Do not use with `pageAfter`.
    From:
      in: query
      name: from
      required: false
      schema:
        type: string
        format: date-time
      description: >
        Filters results starting from the specified timestamp, in ISO 8601
        format.

        Example: 2025-11-17T23:59:59Z
    To:
      in: query
      name: to
      required: false
      schema:
        type: string
        format: date-time
      description: |
        Filters results up to the specified timestamp, in ISO 8601 format.
        Example: 2025-11-17T23:59:59Z
  responses:
    AttestationsListResponse:
      description: Successfully retrieved attestations.
      headers:
        Link:
          description: |
            Provides pagination links for navigating result pages:
            - `rel="self"`: current page
            - `rel="first"`: first page
            - `rel="next"`: next page
            - `rel="prev"`: previous page
          schema:
            type: string
          example: >-
            <https://xreserve-api.circle.com/v1/remote-domains/1/attestations?pageSize=50>;
            rel="self",
            <https://xreserve-api.circle.com/v1/remote-domains/1/attestations?pageSize=50>;
            rel="first",
            <https://xreserve-api.circle.com/v1/remote-domains/1/attestations?pageSize=50&pageAfter=eyJ2YWx1ZXM...>;
            rel="next"
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AttestationsListResponse'
    ErrorResponse:
      description: Standard error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    AttestationsListResponse:
      type: object
      description: Contains a list of returned attestations.
      properties:
        attestations:
          type: array
          description: Contains an array of attestations.
          items:
            $ref: '#/components/schemas/AttestationObject'
      required:
        - attestations
    ErrorResponse:
      type: object
      description: Standard error response.
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Error message
    AttestationObject:
      type: object
      description: Contains attestation data.
      properties:
        payload:
          type: string
          pattern: ^0x[a-fA-F0-9]*$
          description: The encoded attestation payload data.
          example: '0x123456'
        messageHash:
          type: string
          pattern: ^0x[a-fA-F0-9]{64}$
          description: The deposit message hash that identifies the attestation.
        attestation:
          type: string
          pattern: ^0x[a-fA-F0-9]*$
          description: The xReserve attestation signature.
      required:
        - payload
        - messageHash
        - attestation

````