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

# Get deposit instructions for an account

> Permissions required: **Create addresses**

Retrieve deposit instructions for a single asset this account can receive deposits in,
fiat or crypto. If this account has no deposit instructions yet for the requested
asset, they are created on demand and returned.



## OpenAPI

````yaml /knowledge-base/openapi/v4.yaml get /accounts/{accountId}/deposit-instructions/{assetType}
openapi: 3.1.0
info:
  title: Anchorage Digital Account APIs (v4)
  version: 4.0.0-beta
  description: >-
    Reference for the Anchorage Digital v4 API, the surface behind Crypto as a
    Service: account management (accounts and the account tree, beneficiaries,
    freeze/unfreeze/close), balances and transactions, trusted destinations,
    orders and allocations, withdrawals, deposit instructions, deposit
    attributions, the policy engine (policies, approval keys), and supported
    asset types. Approval groups, endorsements, compliance profiles, customers
    (onboarding), fee configuration updates, interest enrollment, funding
    allocations, and destination removal are under construction and return
    mocked data only.


    Status: BETA. The v4 API is available in the sandbox only
    (https://api.anchorage-staging.com/v4) and is not available in production
    yet. The contract may change until general availability. Which endpoints are
    live, in final testing, or under construction:
    https://docs.anchorage.com/platform/developers/caas/caas-overview


    Authentication: every request carries an `Api-Access-Key` header. Every
    POST, PATCH, and DELETE additionally requires an `Idempotency-Key`, and is
    signed with `Api-Signature` (hex-encoded Ed25519 over
    `timestamp_epoch_seconds + uppercase(http_method) + request_path +
    request_body`) plus `Api-Timestamp` (unix epoch seconds).


    Pagination: list endpoints accept `after` (cursor) and `limit` (page size, 1
    to 1000, default 100) and return a `page.endCursor` to continue from. Errors
    use a common envelope with a human-readable `message`; batch endpoints
    return a result per item instead.


    Guides: https://docs.anchorage.com/platform/developers/caas/caas-overview
servers:
  - url: https://api.anchorage-staging.com/v4
security:
  - Api-Access-Key: []
tags:
  - name: Accounts
  - name: Compliance Profiles
  - name: Balances
  - name: Transactions
  - name: Trusted Destinations
  - name: Orders & Allocations
  - name: Withdrawals
  - name: Deposit Instructions
  - name: Deposit Attributions
  - name: Policies
  - name: Approval Groups
  - name: Endorsements
  - name: Customers
  - name: Asset Types
paths:
  /accounts/{accountId}/deposit-instructions/{assetType}:
    get:
      tags:
        - Deposit Instructions
      summary: Get deposit instructions for an account
      description: >-
        Permissions required: **Create addresses**


        Retrieve deposit instructions for a single asset this account can
        receive deposits in,

        fiat or crypto. If this account has no deposit instructions yet for the
        requested

        asset, they are created on demand and returned.
      operationId: getAccountDepositInstructions
      parameters:
        - name: accountId
          in: path
          schema:
            type: string
            format: uuid
            example: 3486b413-93d3-4447-afce-2b9c9dc34a32
          required: true
          description: Unique identifier for the account
        - example: USD
          name: assetType
          in: path
          required: true
          description: >-
            The asset to retrieve deposit instructions for, fiat or crypto (e.g.
            "USD" or "BTC")
          schema:
            type: string
      responses:
        '200':
          description: successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDepositInstructionsResponse'
              examples:
                usd:
                  summary: asset=USD
                  value:
                    assetType: USD
                    rails:
                      - railType: WIRE
                        bankName: Anchorage Digital Bank, NA
                        bankAccountNumber: 123456789
                        bankRoutingNumber: '021000021'
                        bankSwiftCode: CHASUS33
                        bankAddress: 270 Park Avenue, New York, NY 10017
                        beneficiaryName: John Smith
                        beneficiaryAddress: 1220 Rosecrans Ave, Manhattan Beach, CA 90266
                usdWithIntermediary:
                  summary: asset=USD, routed through an intermediary bank
                  value:
                    assetType: USD
                    rails:
                      - railType: WIRE
                        bankName: Anchorage Digital Bank, NA
                        bankAccountNumber: 123456789
                        bankRoutingNumber: '021000021'
                        bankAddress: 270 Park Avenue, New York, NY 10017
                        beneficiaryName: John Smith
                        beneficiaryAddress: 1220 Rosecrans Ave, Manhattan Beach, CA 90266
                        intermediaryBankName: The Bank of New York Mellon
                        intermediaryBankAddress: 240 Greenwich Street, New York, NY 10286
                        intermediaryBankSwiftCode: IRVTUS3N
                btc:
                  summary: asset=BTC
                  value:
                    assetType: BTC
                    rails:
                      - railType: BLOCKCHAIN
                        networkId: BTC
                        walletAddress: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
                eth:
                  summary: asset=ETH
                  value:
                    assetType: ETH
                    rails:
                      - railType: BLOCKCHAIN
                        networkId: ETH
                        walletAddress: '0x32Bd336A658eD7D0DC508154bd3F6a87E31b3EBa'
                usdt:
                  summary: asset=USDT
                  value:
                    assetType: USDT
                    rails:
                      - railType: BLOCKCHAIN
                        networkId: ETH
                        walletAddress: '0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '502':
          description: Bad Gateway
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '504':
          description: Gateway Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
components:
  schemas:
    AccountDepositInstructionsResponse:
      title: Account Deposit Instructions Response
      type: object
      description: >-
        Deposit instructions for a single asset, across all rails this account
        supports for it.
      required:
        - assetType
        - rails
      properties:
        assetType:
          type: string
          description: >-
            A string representing a type of asset, which usually corresponds to
            the asset's ticker symbol. Use `/asset-types` to list all of the
            supported asset types for your organization.
          example: USD
        rails:
          type: array
          items:
            $ref: '#/components/schemas/DepositRail'
          description: Rails supported for depositing this asset (e.g. Wire, Blockchain).
    ErrorDetails:
      title: ErrorDetails
      type: object
      properties:
        message:
          description: A human-readable message providing more details about the error.
          example: Missing required field 'amount'.
          type: string
      required:
        - message
    DepositRail:
      title: Deposit Rail
      description: Deposit instructions for a single rail supported for an asset.
      discriminator:
        propertyName: railType
        mapping:
          WIRE: '#/components/schemas/WireDepositRail'
          BLOCKCHAIN: '#/components/schemas/BlockchainDepositRail'
      oneOf:
        - $ref: '#/components/schemas/WireDepositRail'
        - $ref: '#/components/schemas/BlockchainDepositRail'
    WireDepositRail:
      title: Wire Deposit Rail
      type: object
      description: Deposit instructions for a Wire (Fedwire) transfer.
      required:
        - railType
      properties:
        railType:
          type: string
          enum:
            - WIRE
          default: WIRE
          description: Discriminator field indicating a Wire deposit rail
        bankName:
          description: Bank name
          type: string
        bankAccountNumber:
          description: Bank Account Number
          type: string
        bankRoutingNumber:
          description: Bank Routing Number
          type: string
          pattern: ^\d{9}$
        bankSwiftCode:
          description: Bank Swift Code
          type: string
        bankAddress:
          description: Bank Address
          type: string
        beneficiaryName:
          description: Beneficiary Name
          type: string
        beneficiaryAddress:
          description: Beneficiary Address
          type: string
        intermediaryBankName:
          description: Intermediary Bank Name.
          type: string
        intermediaryBankAddress:
          description: Intermediary Bank Address
          type: string
        intermediaryBankSwiftCode:
          description: Intermediary Bank Swift Code
          type: string
    BlockchainDepositRail:
      title: Blockchain Deposit Rail
      type: object
      description: Deposit instructions for an on-chain (blockchain) transfer.
      required:
        - railType
        - networkId
        - walletAddress
      properties:
        railType:
          type: string
          enum:
            - BLOCKCHAIN
          default: BLOCKCHAIN
          description: Discriminator field indicating a blockchain deposit rail
        networkId:
          type: string
          description: >-
            A unique string identifying a combination of blockchain and
            environment (testnet, mainnet).
          example: BTC
        walletAddress:
          type: string
          description: >-
            The wallet address for depositing on-chain. On chains with multiple
            address types (e.g. Solana wallet address vs associated token
            account), this is always the wallet address.
          example: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
  securitySchemes:
    Api-Access-Key:
      type: apiKey
      name: Api-Access-Key
      in: header
      description: An API key associated with a security role

````

## Related topics

- [Deposit](https://docs.anchorage.com/knowledge-base/platform/developers/named-virtual-accounts/named-virtual-accounts-deposit.md)
- [Crypto deposits](https://docs.anchorage.com/knowledge-base/platform/developers/caas/caas-deposits-crypto.md)
- [Get a virtual account](https://docs.anchorage.com/knowledge-base/api-reference/v2-platforms/virtual-accounts/get-a-virtual-account.md)
- [USD deposits](https://docs.anchorage.com/knowledge-base/platform/developers/caas/caas-deposits-usd.md)
- [Accounts](https://docs.anchorage.com/knowledge-base/platform/developers/caas/caas-accounts.md)
