> ## 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.

# Get an attestation for a crosschain transfer

> Returns the attestation for a specified crosschain transfer using the deposit message hash.



## OpenAPI

````yaml openapi/xreserve.yaml get /v1/attestations/{depositMessageHash}
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/attestations/{depositMessageHash}:
    get:
      tags:
        - xReserve
      summary: Get an attestation for a crosschain transfer
      description: >-
        Returns the attestation for a specified crosschain transfer using the
        deposit message hash.
      operationId: getAttestation
      parameters:
        - $ref: '#/components/parameters/DepositMessageHash'
      responses:
        '200':
          $ref: '#/components/responses/AttestationResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '404':
          $ref: '#/components/responses/ErrorResponse'
        '500':
          $ref: '#/components/responses/ErrorResponse'
components:
  parameters:
    DepositMessageHash:
      in: path
      name: depositMessageHash
      required: true
      schema:
        type: string
        pattern: ^0x[a-fA-F0-9]{64}$
      description: The hash of the deposit message as a 32-byte hexadecimal string.
      example: '0x1234567890123456789012345678901234567890123456789012345678901234'
  responses:
    AttestationResponse:
      description: Successfully retrieved attestation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AttestationResponse'
    ErrorResponse:
      description: Standard error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    AttestationResponse:
      type: object
      description: Contains attestation data.
      required:
        - attestation
      properties:
        attestation:
          $ref: '#/components/schemas/AttestationObject'
    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

````