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

# Get Circle Gateway deposit vault status

> Returns the persisted quoted gateway intent state and metadata for a vault address.



## OpenAPI

````yaml /gateway_fast_deposits_openapi.json get /circle-gateway/v2/depositAddresses/{vaultAddress}
openapi: 3.0.0
info:
  title: Circle Gateway Fast Deposits API
  version: 2.0.0
  description: >-
    REST API for creating quoted Circle Gateway deposit vaults, queueing gasless
    funding via ERC-3009, polling vault and job status.
servers:
  - url: https://api.eco.com
    description: Mainnet
security: []
tags:
  - name: Circle Gateway
  - name: Gasless funding
paths:
  /circle-gateway/v2/depositAddresses/{vaultAddress}:
    get:
      tags:
        - Circle Gateway
      summary: Get Circle Gateway deposit vault status
      description: >-
        Returns the persisted quoted gateway intent state and metadata for a
        vault address.
      operationId: getCircleGatewayDepositVaultStatus
      parameters:
        - name: vaultAddress
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/EvmAddress'
        - name: sourceChainId
          in: query
          required: true
          description: Source chain ID where the vault is funded.
          schema:
            type: number
            example: 8453
      responses:
        '200':
          description: Quoted vault record retrieved successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: >-
                      #/components/schemas/CircleGatewayDepositAddressStatusResponseDTO
        '400':
          description: Invalid vaultAddress or sourceChainId
        '404':
          description: Vault not found
components:
  schemas:
    EvmAddress:
      type: string
      pattern: ^0x[a-fA-F0-9]{40}$
      description: EIP-55 / lowercase hex 20-byte address
      example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
    CircleGatewayDepositAddressStatusResponseDTO:
      type: object
      required:
        - vaultAddress
        - amount
        - deadline
        - state
        - intentHash
        - sourceChainId
      properties:
        vaultAddress:
          $ref: '#/components/schemas/EvmAddress'
          description: Vault address on the source chain.
        amount:
          type: string
          description: Requested source-chain USDC amount in base units.
          example: '1000000'
        deadline:
          type: number
          description: Unix seconds quote deadline.
          example: 1798915200
        state:
          $ref: '#/components/schemas/QuotedGatewayIntentState'
        intentHash:
          $ref: '#/components/schemas/Hex32'
          description: >-
            Intent hash for this quoted vault, assigned at quote creation and
            preserved through publish.
        sourceChainId:
          type: number
          description: Source chain ID where the vault is funded.
          example: 8453
    QuotedGatewayIntentState:
      type: string
      description: >-
        Current quoted gateway intent state. `PENDING`: vault created, waiting
        for funds. `FUNDING_DETECTED`: vault balance reached the quoted amount.
        `PUBLISHED`: deposit intent published onchain. `EXPIRED_UNFUNDED`: quote
        deadline passed without funding. `FAILED`, `REFUNDED_BY_USER`,
        `RECOVERY_PUBLISHED`: terminal recovery outcomes.
      enum:
        - PENDING
        - FUNDING_DETECTED
        - PUBLISHED
        - FAILED
        - REFUNDED_BY_USER
        - RECOVERY_PUBLISHED
        - EXPIRED_UNFUNDED
    Hex32:
      type: string
      pattern: ^0x[a-fA-F0-9]{64}$
      description: 0x-prefixed 32-byte hex (64 hex chars)

````