> ## Documentation Index > Fetch the complete documentation index at: https://docs.tracefinance.com/llms.txt > Use this file to discover all available pages before exploring further. # List funding instructions > Retrieves funding instructions for depositing into an account across all available payment rails. ## OpenAPI ````yaml apis/fx-account/openapi.yml GET /v1/accounts/{accountId}/fundingInstructions openapi: 3.1.1 info: title: FX Account API version: 1.0.0 description: API for managing multi-currency accounts on the Trace Finance platform. servers: - url: https://api.sandbox.tracefinance.com description: Sandbox security: - bearerAuth: [] tags: - name: Accounts description: Create, list, and manage multi-currency accounts. - name: Beneficial owners description: Manage beneficial owners (UBOs) for company-owned accounts. - name: Funding instructions description: Retrieve funding instructions for depositing into an account. - name: Balances description: Retrieve fiat and crypto balances for an account. paths: /v1/accounts/{accountId}/fundingInstructions: get: tags: - Funding instructions summary: List funding instructions description: >- Retrieves funding instructions for depositing into an account. Returns all available payment rails (PIX, TED, Boleto, crypto). Optionally filter by `asset` and/or `rail`. operationId: listFundingInstructions parameters: - $ref: '#/components/parameters/AccountId' - $ref: '#/components/parameters/TraceVersion' - name: asset in: query required: false description: Filter results by asset code. schema: $ref: '#/components/schemas/Asset' - name: rail in: query required: false description: Filter results by payment rail. schema: $ref: '#/components/schemas/Rail' responses: '200': description: List of funding instructions. headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: type: array items: $ref: '#/components/schemas/FundingInstructionResponse' examples: mixed: summary: PIX and TED instructions value: - asset: BRL type: PIX_KEY rail: PIX_KEY keyType: CNPJ key: '12345678000101' accountIdentifier: null - asset: BRL type: TED rail: TED bankCode: '001' branch: '0001' accountNumber: 123456-7 accountType: CHECKING '400': description: Invalid account ID format. headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidUuid: $ref: '#/components/examples/InvalidAccountIdUuid' '401': $ref: '#/components/responses/UnauthorizedError' '404': description: Account not found. headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: accountNotFound: $ref: '#/components/examples/AccountNotFound' components: parameters: AccountId: name: accountId in: path required: true description: UUID of the account. schema: type: string format: uuid TraceVersion: name: X-Trace-Version in: header required: false description: API version. Omit to use the default version. schema: type: string example: '1' schemas: Asset: type: string enum: - BRL - USDT - USDC description: > ISO 4217 currency code or stablecoin ticker. The maximum decimal scale of an `AmountValue` paired with this asset depends on the asset: | Asset | Decimals | |---|---| | BRL | 2 | | USDT | 6 | | USDC | 6 | example: BRL Rail: type: string description: Payment rail used to fund a deposit. enum: - PIX_KEY - PIX_STATIC_QR_CODE - PIX_DYNAMIC_QR_CODE - PIX_BANK_INSTRUCTION - BOLETO - CRYPTO - TED - WIRE - SWIFT - SEPA - ACH FundingInstructionResponse: description: >- A funding instruction for depositing into an account. Discriminated by `type`. oneOf: - $ref: '#/components/schemas/PixKeyFundingInstruction' - $ref: '#/components/schemas/PixStaticQrCodeFundingInstruction' - $ref: '#/components/schemas/PixBankInstructionFundingInstruction' - $ref: '#/components/schemas/TedFundingInstruction' - $ref: '#/components/schemas/BoletoFundingInstruction' - $ref: '#/components/schemas/CryptoWalletFundingInstruction' discriminator: propertyName: type mapping: PIX_KEY: $ref: '#/components/schemas/PixKeyFundingInstruction' PIX_STATIC_QR_CODE: $ref: '#/components/schemas/PixStaticQrCodeFundingInstruction' PIX_BANK_INSTRUCTION: $ref: '#/components/schemas/PixBankInstructionFundingInstruction' TED: $ref: '#/components/schemas/TedFundingInstruction' BOLETO: $ref: '#/components/schemas/BoletoFundingInstruction' CRYPTO_WALLET: $ref: '#/components/schemas/CryptoWalletFundingInstruction' ErrorResponse: type: object description: >- Standard error envelope. The HTTP response also carries an `X-Request-Id` header — reference it when contacting Trace Finance support. See [Errors](/guides/principles/errors). properties: code: type: string description: Machine-readable error code. message: type: string description: Human-readable description. details: type: object additionalProperties: true required: - code - message PixKeyFundingInstruction: title: PIX key allOf: - $ref: '#/components/schemas/FundingInstructionBase' - type: object properties: type: type: string enum: - PIX_KEY rail: type: string enum: - PIX_KEY keyType: type: string description: PIX key type. enum: - CPF - CNPJ - EMAIL - PHONE - RANDOM example: CNPJ key: type: string description: The PIX key value. example: '12345678000101' accountIdentifier: type: - string - 'null' description: >- Optional account identifier exposed by the underlying provider, useful when the same key is shared across multiple accounts. example: null required: - keyType - key PixStaticQrCodeFundingInstruction: title: PIX static QR code allOf: - $ref: '#/components/schemas/FundingInstructionBase' - type: object properties: type: type: string enum: - PIX_STATIC_QR_CODE rail: type: string enum: - PIX_STATIC_QR_CODE qrCode: type: string description: Static QR code payload (EMV format). example: 00020126580014br.gov.bcb.pix... required: - qrCode PixBankInstructionFundingInstruction: title: PIX bank instruction allOf: - $ref: '#/components/schemas/FundingInstructionBase' - type: object properties: type: type: string enum: - PIX_BANK_INSTRUCTION rail: type: string enum: - PIX_BANK_INSTRUCTION bankCode: type: string description: COMPE bank code. example: '001' ispbCode: type: string description: ISPB code of the bank, derived from `bankCode`. example: '00000000' branch: type: string description: Branch number. example: '0001' accountNumber: type: string description: Account number. example: 123456-7 accountType: type: string description: Type of bank account. example: CHECKING required: - bankCode - ispbCode - branch - accountNumber - accountType TedFundingInstruction: title: TED allOf: - $ref: '#/components/schemas/FundingInstructionBase' - type: object properties: type: type: string enum: - TED rail: type: string enum: - TED bankCode: type: string description: Bank code (ISPB or COMPE). example: '001' branch: type: string description: Branch number. example: '0001' accountNumber: type: string description: Account number. example: 123456-7 accountType: type: string description: Type of bank account. example: CHECKING required: - bankCode - branch - accountNumber - accountType BoletoFundingInstruction: title: Boleto allOf: - $ref: '#/components/schemas/FundingInstructionBase' - type: object properties: type: type: string enum: - BOLETO rail: type: string enum: - BOLETO barcode: type: string description: Boleto barcode (digitable line). example: 23793.38128 60800.000003 00000.000400 1 84340000012345 dueDate: type: string format: date-time description: Payment due date. example: '2026-04-04T00:00:00Z' required: - barcode - dueDate CryptoWalletFundingInstruction: title: Crypto wallet allOf: - $ref: '#/components/schemas/FundingInstructionBase' - type: object properties: type: type: string enum: - CRYPTO_WALLET rail: type: string enum: - CRYPTO network: type: string description: Blockchain network. example: ETHEREUM walletAddress: type: string description: Deposit wallet address. example: '0x1234567890abcdef1234567890abcdef12345678' required: - network - walletAddress FundingInstructionBase: type: object properties: asset: $ref: '#/components/schemas/Asset' type: $ref: '#/components/schemas/FundingInstructionType' rail: $ref: '#/components/schemas/Rail' required: - asset - type - rail FundingInstructionType: type: string description: >- Funding instruction shape. Each value maps to one variant of `FundingInstructionResponse`. enum: - PIX_KEY - PIX_STATIC_QR_CODE - PIX_BANK_INSTRUCTION - TED - BOLETO - CRYPTO_WALLET headers: RequestId: description: >- Unique request identifier emitted on every response. Reference it when contacting Trace Finance support so we can trace the request end-to-end. See [Errors](/guides/principles/errors). schema: type: string format: uuid examples: InvalidAccountIdUuid: summary: accountId path parameter is not a valid UUID value: code: INVALID_DATA message: Object contains invalid data details: errors: - code: INVALID_UUID message: '''not-a-uuid'' cannot be converted to UUID' field: path:accountId params: {} AccountNotFound: summary: Account does not exist for the authenticated customer value: code: RESOURCE_NOT_FOUND message: >- Account with given parameters [Account.id:5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c, Customer.id:c1a2b3c4-d5e6-7890-abcd-ef1234567890] not found details: resource: Account parameters: Account.id: 5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c Customer.id: c1a2b3c4-d5e6-7890-abcd-ef1234567890 InvalidToken: summary: Bearer token is invalid or malformed value: code: INVALID_ACCESS_TOKEN message: Invalid access token details: {} ExpiredToken: summary: Bearer token has expired value: code: EXPIRED_ACCESS_TOKEN message: Expired access token details: {} responses: UnauthorizedError: description: Missing or invalid authentication token. headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidToken: $ref: '#/components/examples/InvalidToken' expiredToken: $ref: '#/components/examples/ExpiredToken' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT bearer token. Include as `Authorization: Bearer `. See the [Authentication](/guides/authentication) guide for how to obtain one. ````