> ## 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 attestations by source transaction hash

> Returns all attestations associated with the specified source chain transaction hash.
A single transaction may produce multiple attestations across different remote domains.




## OpenAPI

````yaml openapi/xreserve.yaml get /v1/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/attestations:
    get:
      tags:
        - xReserve
      summary: Get attestations by source transaction hash
      description: >
        Returns all attestations associated with the specified source chain
        transaction hash.

        A single transaction may produce multiple attestations across different
        remote domains.
      operationId: getAttestationsByTxHash
      parameters:
        - $ref: '#/components/parameters/TxHash'
      responses:
        '200':
          $ref: '#/components/responses/AttestationsByTxHashResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '500':
          $ref: '#/components/responses/ErrorResponse'
components:
  parameters:
    TxHash:
      in: query
      name: txHash
      required: true
      schema:
        type: string
        pattern: ^0x[a-fA-F0-9]{64}$
      description: The source chain transaction hash as a 32-byte hexadecimal string.
      example: '0x1234567890123456789012345678901234567890123456789012345678901234'
  responses:
    AttestationsByTxHashResponse:
      description: Successfully retrieved attestations for the transaction hash.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AttestationsByTxHashResponse'
    ErrorResponse:
      description: Standard error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    AttestationsByTxHashResponse:
      type: object
      description: Contains attestations associated with a source chain transaction.
      properties:
        attestations:
          type: array
          description: Contains an array of attestations for the transaction.
          items:
            $ref: '#/components/schemas/AttestationWithRemoteDomainObject'
      required:
        - attestations
    ErrorResponse:
      type: object
      description: Standard error response.
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Error message
    AttestationWithRemoteDomainObject:
      allOf:
        - $ref: '#/components/schemas/AttestationObject'
        - type: object
          required:
            - remoteDomain
          properties:
            remoteDomain:
              type: integer
              minimum: 1
              description: The remote domain identifier for this attestation.
              example: 42161
    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

````