> ## 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 withdrawal status

> Returns the status and transfer details of a specified withdrawal group.



## OpenAPI

````yaml openapi/xreserve.yaml get /v1/withdrawal/{withdrawalId}
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/withdrawal/{withdrawalId}:
    get:
      tags:
        - xReserve
      summary: Get withdrawal status
      description: Returns the status and transfer details of a specified withdrawal group.
      operationId: getWithdrawalStatus
      parameters:
        - $ref: '#/components/parameters/WithdrawalId'
      responses:
        '200':
          $ref: '#/components/responses/WithdrawalResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '404':
          $ref: '#/components/responses/ErrorResponse'
        '500':
          $ref: '#/components/responses/ErrorResponse'
components:
  parameters:
    WithdrawalId:
      in: path
      name: withdrawalId
      required: true
      schema:
        type: string
        format: uuid
      description: >-
        Unique identifier of the withdrawal group returned by the `/withdraw`
        endpoint.
      example: 123e4567-e89b-12d3-a456-426614174000
  responses:
    WithdrawalResponse:
      description: Successfully retrieved withdrawal status.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WithdrawalResponse'
    ErrorResponse:
      description: Standard error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    WithdrawalResponse:
      type: object
      description: Contains withdrawal status and details
      properties:
        withdrawalId:
          type: string
          format: uuid
          description: The unique identifier of the withdrawal group.
          example: 6149dc3d-71bf-4d57-8cc1-5e2d4c0a8e70
        burnTxId:
          type: string
          pattern: ^0x[a-fA-F0-9]+$
          description: The transaction ID of the burn on the remote network.
          example: '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890'
        status:
          type: string
          enum:
            - created
            - verified
            - confirmed
            - finalized
            - expired
            - failed
          description: >
            The status of the withdrawal.

            - 'created': The withdrawal has been created but the burn
            transaction on the remote network has not been verified yet.

            - 'verified': The burn transaction on the remote network has been
            successfully verified. The attestation is available but has been
            submitted on chain yet.

            - 'confirmed': The attestation has been submitted onchain but the
            transaction has not been finalized yet.

            - 'finalized': The transaction has been successfully finalized. This
            state is terminal.

            - 'expired': The attestation expired before it was used. This state
            is terminal and can be retried.

            - 'failed': The verification failed. The withdrawal cannot proceed.
            This state is terminal and cannot be retried.
        attestationPayload:
          type: string
          pattern: ^0x[a-fA-F0-9]*$
          description: The full attestation payload.
        attestation:
          type: string
          pattern: ^0x[a-fA-F0-9]*$
          description: The xReserve attestation signature.
        useCircleForwarding:
          type: boolean
          description: >-
            Indicates whether Circle should forward the transaction and release
            funds on either a CCTP supported blockchain or another remote
            blockchain.
          example: true
        transactionHash:
          type: string
          pattern: ^0x[a-fA-F0-9]{64}$
          description: The hash of forwarded transaction.
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
        failureReason:
          type: string
          description: The reason for failure. Returned when the `status` is 'failed'.
          example: verification_failed
        transferSpecHashes:
          type: array
          description: >-
            List of transfer specification hashes for all withdrawal intents in
            the group.
          items:
            type: string
            pattern: ^0x[a-fA-F0-9]{64}$
          example:
            - '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
      required:
        - withdrawalId
        - burnTxId
        - status
        - useCircleForwarding
        - transferSpecHashes
    ErrorResponse:
      type: object
      description: Standard error response.
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Error message

````