> ## 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. # List all transfers > Searches for transfers from your business account. If the date parameters are omitted, returns the most recent transfers. This endpoint returns up to 50 transfers in descending chronological order or pageSize, if provided. ## OpenAPI ````yaml openapi/account.yaml get /v1/businessAccount/transfers openapi: 3.0.2 info: version: ${version} title: Core Functionality description: > All of Circle's APIs share a common set of core functionality that lets you manage your Circle Account in a programmatic way. With a Circle Account your business can deposit traditional money from 80+ countries and seamlessly convert them into "digital currency dollars": USDC. You can then use USDC for everyday payments and treasury flows. servers: - url: https://api-sandbox.circle.com - url: https://api.circle.com security: [] tags: - name: Balances description: Get information on settled and unsettled balances. - name: Payouts description: Create and get information on 1st party payouts. - name: Wires description: >- Create, get instructions, and get information on 1st party bank accounts for wire transfers. - name: CUBIX description: Create and get information on CUBIX accounts. - name: PIX description: Create and get information on PIX accounts. - name: Transfers description: Create and get information on 1st party transfers. - name: Addresses description: Generate and get information on blockchain addresses. - name: Deposits description: Get information on 1st party deposits. - name: Payments description: Create, cancel, refund, and get updates on card payments. - name: Settlement Bank Routing description: View and manage settlement bank routing preferences for fiat accounts. - name: Reporting description: >- Retrieve transaction and balance reports, including ISO 20022 (CAMT.053) statements and managed-payment reports. paths: /v1/businessAccount/transfers: get: tags: - Transfers summary: List all transfers description: >- Searches for transfers from your business account. If the date parameters are omitted, returns the most recent transfers. This endpoint returns up to 50 transfers in descending chronological order or pageSize, if provided. operationId: listBusinessTransfers parameters: - name: walletId description: Filters results to get only transfers to or from this Circle wallet. in: query required: false schema: type: string - name: sourceWalletId description: > Filters results to get only transfers from this Circle wallet. You can get wallet IDs associated with your account using the [Core API for Institutions](/api-reference/circle-mint/institutional/get-all-external-entities). in: query required: false schema: type: string - name: destinationWalletId description: Filters results to get only transfers to this Circle wallet. in: query required: false schema: type: string - $ref: '#/components/parameters/From' - $ref: '#/components/parameters/To' - $ref: '#/components/parameters/PageBefore' - $ref: '#/components/parameters/PageAfter' - $ref: '#/components/parameters/PageSize' responses: '200': description: Successfully retrieved a list of transfers. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: title: ListBusinessTransfersResponse properties: data: type: array items: $ref: '#/components/schemas/Transfer' examples: response: value: data: - id: b8627ae8-732b-4d25-b947-1df8f4007a29 source: type: wallet id: '12345' identities: - type: individual name: Satoshi Nakamoto addresses: - line1: 100 Money Street line2: Suite 1 city: Boston district: MA postalCode: '01234' country: US useMainWalletFunding: false destination: type: blockchain address: '0x8381470ED67C3802402dbbFa0058E8871F017A6F' addressTag: '123456789' chain: ALGO amount: amount: '3.14' currency: USD fees: - amount: '10.00' currency: USD type: network transactionHash: >- 0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63 status: pending errorCode: transfer_failed createDate: '2020-04-10T02:13:30.000Z' customerExternalRef: INV-2024-001234 '401': $ref: '#/components/responses/NotAuthorized' security: - bearerAuth: [] components: parameters: From: name: from description: Queries items created since the specified date-time (inclusive). in: query required: false schema: type: string format: date-time example: '2020-04-10T02:13:30.000Z' To: name: to description: Queries items created before the specified date-time (inclusive). in: query required: false schema: type: string format: date-time example: '2020-04-10T02:13:30.000Z' PageBefore: name: pageBefore description: > A collection ID value used for pagination. It marks the exclusive end of a page. When provided, the collection resource will return the next `n` items before the id, with `n` being specified by `pageSize`. The items will be returned in the natural order of the collection. The resource will return the first page if neither `pageAfter` nor `pageBefore` are specified. SHOULD NOT be used in conjuction with pageAfter. in: query required: false schema: type: string PageAfter: name: pageAfter description: > A collection ID value used for pagination. It marks the exclusive begin of a page. When provided, the collection resource will return the next `n` items after the id, with `n` being specified by `pageSize`. The items will be returned in the natural order of the collection. The resource will return the first page if neither `pageAfter` nor `pageBefore` are specified. SHOULD NOT be used in conjuction with pageBefore. in: query required: false schema: type: string PageSize: name: pageSize description: > Limits the number of items to be returned. Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used. If avoided, the collection will determine the page size itself. in: query required: false schema: type: integer minimum: 1 example: 5 headers: XRequestId: description: >- Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support. schema: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde schemas: Transfer: type: object description: A transfer of funds. required: - id - source - destination - amount - status properties: id: $ref: '#/components/schemas/Id' source: $ref: '#/components/schemas/TransferSourceLocation' destination: $ref: '#/components/schemas/TransferDestinationLocation' amount: $ref: '#/components/schemas/Money' fees: description: >- An array of fees applied to a transaction. This is only available when there is at least one non-zero fee. type: array items: $ref: '#/components/schemas/Fee' transactionHash: description: >- A hash that uniquely identifies the onchain transaction. This is only available where either source or destination are of type blockchain. type: string example: '0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63' status: description: >- Status of the transfer. Status `pending` indicates that the transfer is in the process of running; `complete` indicates it finished successfully; `failed` indicates it failed. Circle Mint Singapore customers may have transfers in the `pending` status if the recipient addresses are not verified. type: string enum: - pending - complete - failed errorCode: $ref: '#/components/schemas/TransferErrorCode' createDate: description: The create date of the transfer. type: string format: date-time customerExternalRef: $ref: '#/components/schemas/CustomerExternalRef' description: A customer-supplied reference during transfer creation. Id: type: string description: Unique system generated identifier for the entity. format: uuid example: b8627ae8-732b-4d25-b947-1df8f4007a29 TransferSourceLocation: description: A source of funds. oneOf: - $ref: '#/components/schemas/TransferSourceWalletLocation' - $ref: '#/components/schemas/TransferSourceBlockchainLocation' TransferDestinationLocation: description: A destination of funds. oneOf: - $ref: '#/components/schemas/TransferDestinationBlockchainLocation' - $ref: '#/components/schemas/TransferDestinationWalletLocation' Money: type: object required: - amount - currency properties: amount: type: string description: Magnitude of the amount, in units of the currency, with a `.`. example: '3.14' currency: type: string description: Currency code for the amount. enum: - USD - EUR - BTC - ETH - CIRBTC Fee: type: object required: - amount - currency - type properties: amount: type: string description: Magnitude of the fee amount, in units of the currency, with a `.`. example: '10.00' currency: type: string description: Currency code for the amount. enum: - USD type: type: string description: Category of the fee. enum: - network TransferErrorCode: type: string description: >- Indicates the failure reason of a transfer. Only present for transfers in a `failed` state. Possible values are `insufficient_funds`, `blockchain_error` and `transfer_denied` and `transfer_failed` nullable: true enum: - transfer_failed - transfer_denied - blockchain_error - insufficient_funds CustomerExternalRef: type: string description: A customer-supplied reference for reconciliation purposes. pattern: ^[A-Za-z0-9-]{1,21}$ example: INV-2024-001234 TransferSourceWalletLocation: description: A source wallet location. type: object required: - type - id properties: type: type: string enum: - wallet id: type: string description: The id of the wallet. example: '12345' identities: type: array items: $ref: '#/components/schemas/Identity' useMainWalletFunding: type: boolean description: > When true, if the designated source wallet lacks sufficient funds for the payout, funds are transferred from the master wallet to the source wallet before the payout executes. For Managed Payments customers only. Default is true. TransferSourceBlockchainLocation: description: A source blockchain address. type: object required: - type - chain properties: type: type: string enum: - blockchain chain: $ref: '#/components/schemas/Chain' identities: type: array items: $ref: '#/components/schemas/Identity' TransferDestinationBlockchainLocation: description: A destination blockchain address. type: object required: - type - chain - address properties: type: type: string enum: - blockchain address: $ref: '#/components/schemas/Address' addressTag: $ref: '#/components/schemas/AddressTag' chain: $ref: '#/components/schemas/Chain' TransferDestinationWalletLocation: description: A destination wallet location. type: object required: - type - id properties: type: type: string enum: - wallet id: type: string description: The id of the wallet. example: '12345' address: type: string description: >- An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address. example: '0x8381470ED67C3802402dbbFa0058E8871F017A6F' addressTag: $ref: '#/components/schemas/AddressTag' Identity: type: object description: | The identity of the originator. Identities are required when: * `destination.type: "blockchain"` * `destination.chain: "ETH"` * `amount.amount` >= $3,000 in value required: - type - name - addresses properties: type: type: string description: > The type of identity for the originator. * `individual` - A uniquely distinguishable individual. * `business` - Any entity other than a natural person that can establish a permanent customer relationship with an affected entity or otherwise own property. This can include companies, foundations, anstalt, partnerships, associations and other relevantly similar entities. enum: - individual - business name: type: string description: Full name of the identity. example: Satoshi Nakamoto maxLength: 1024 addresses: type: array items: $ref: '#/components/schemas/IdentityAddress' Chain: type: string description: > A blockchain that a given currency is available on. **Note:** Arc (`ARC`) is only available in the sandbox environment (`api-sandbox.circle.com`). enum: - ALGO - APTOS - ARB - ARC - AVAX - BASE - BTC - CELO - CODEX - ETH - HBAR - HYPEREVM - INK - LINEA - NEAR - NOBLE - OP - PLUME - PAH - POLY - SEI - SOL - SONIC - SUI - UNI - WORLDCHAIN - XDC - XLM - XRP - ZKS - ZKSYNC Address: type: string description: > An alphanumeric string representing a blockchain address. Formatting varies by blockchain. Be sure to preserve the exact formatting and capitalization of the address. **Important:** For Ripple (XRP) addresses, only the classic address format is supported (for example, `rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY`). The `x-address` format is NOT supported currently (for example, `XV5sbjUmgPpvXv4ixFWZ5ptAYZ6PD2q1qM6owqNbug8W6KV`). example: '0x8381470ED67C3802402dbbFa0058E8871F017A6F' AddressTag: type: string description: >- The secondary identifier for a blockchain address. An example of this is the memo field on the Stellar network, which can be text, id, or hash format. nullable: true example: '123456789' IdentityAddress: type: object required: - line1 - city - district - postalCode - country properties: line1: type: string description: Line one of the street address. maxLength: 1024 example: 100 Money Street line2: type: string description: Line two of the street address. maxLength: 1024 example: Suite 1 city: type: string description: City portion of the address. maxLength: 1024 example: Boston district: description: >- State / County / Province / Region portion of the address. If the country is US or Canada, then district is required and should use the two-letter code for the subdivision. type: string maxLength: 16 example: MA postalCode: type: string description: Postal / ZIP code of the address. maxLength: 16 example: '01234' country: type: string description: >- Country portion of the address. Formatted as a two-letter country code specified in ISO 3166-1 alpha-2. maxLength: 2 example: US responses: NotAuthorized: description: >- The request has not been applied because it lacks valid authentication credentials. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object title: NotAuthorized required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. example: code: 401 message: Malformed authorization. examples: response: value: code: 401 message: Malformed authorization. securitySchemes: bearerAuth: type: http scheme: bearer ````