--- title: "List transfers" method: GET path: "/transfers" tags: ["Transfers"] --- # List transfers `GET /transfers` Permissions required: **Transfer funds** List all transfers created by your API key. **Filters** You may optionally supply the following filters: - Set a date range by providing the `startDate` and/or `endDate` query parameters. If the date parameters are omitted, all transfers will be returned. - Specify a specific vault to return transfers for by specifying the `vaultId` parameter. If the `vaultId` parameter is omitted, transfers originating from all vaults will be returned. Providing both `vaultId` and `walletId` filters will result in an error. - Specify a specific wallet to return transfers for by specifying the `walletId` parameter. If the `walletId` parameter is omitted, transfers originating from all vaults and wallets will be returned. Providing both `vaultId` and `walletId` filters will result in an error. - Filter transfers of one or more statuses with the `statuses` parameter. Multiple statuses should be separated by commas. **Multiple Transfers** To fetch a specific batch of transfers, pass a comma-separated list of `transferIds` as the `transferIds` query parameter. ## Query parameters - `vaultId` string - `walletId` string - `transferIds` string[] - `startDate` string, date - `endDate` string, date - `afterId` string - `limit` integer - `statuses` string[] ## Response `200` A list of transfers. - TransfersResponse - `data` TransferDetails[], required - `amount` Amount, required — An amount of a crypto-asset represented by quantity, assetType, current unit price and current USD value. Fee amounts will be estimates if a transaction is not final. NOTE: price and USD value information is recent but does not reflect real-time data. - `assetType` string, required — A string representing a type of crypto-asset, which usually corresponds to the crypto asset's ticker symbol. Use `/asset-types` to list all of the supported asset types for your organization. - `currentPrice` string — A recent assessment of the intra-day USD value of 1 unit of this asset type. This value is provided for convenience for such use cases as estimating point-in-time portfolio balances. This value does not represent authoritative pricing information used by Anchorage Digital for any purpose. The price is fetched as of the present, and may be omitted in certain contexts where more structured pricing information is provided (e.g. quotes and trades). - `currentUSDValue` string — The result of `quantity * currentPrice`, rounded to the nearest cent. A unitless number implicitly denominated in dollars. See `currentPrice` for methodology and disclaimers. - `quantity` string, required — The numeric value of this amount, excluding units - `assetType` string, required — A string representing a type of crypto-asset, which usually corresponds to the crypto asset's ticker symbol. Use `/asset-types` to list all of the supported asset types for your organization. - `blockchainTxId` string — The blockchain transaction ID, if applicable - `createdAt` string, date-time, required — The timestamp when the transfer request was created - `destination` ResourceDetails — An object representing a resource capable of receiving, or holding funds. Construction example: ``` { "id":"1c920f4241b78a1d483a29f3c24b6c4c", "type":"WALLET" } ``` - `id` string, required — The identifier of the resource - `type` 'VAULT' | 'WALLET' | 'ADDRESS' | 'STANDING_INSTRUCTION', required — The type of the resource being referenced. Note that the VAULT type has been deprecated and WALLET should be used instead. - `endedAt` string, date-time, nullable — The timestamp when the transfer request reached a final state - completion or failure (optional) - `error` ErrorDetails - `errorType` 'InternalError' | 'InvalidRequest' | 'Unauthenticated' | 'Forbidden' | 'NotFound' | 'Conflict' | 'UnprocessableEntity' | 'TooManyRequests' | 'ServiceUnavailable' | 'QuoteExpired' | 'InsufficientFunds' | 'NotImplemented', required — The type of error returned. - `message` string, required — A human-readable message providing more details about the error. - `fee` Amount — An amount of a crypto-asset represented by quantity, assetType, current unit price and current USD value. Fee amounts will be estimates if a transaction is not final. NOTE: price and USD value information is recent but does not reflect real-time data. - `assetType` string, required — A string representing a type of crypto-asset, which usually corresponds to the crypto asset's ticker symbol. Use `/asset-types` to list all of the supported asset types for your organization. - `currentPrice` string — A recent assessment of the intra-day USD value of 1 unit of this asset type. This value is provided for convenience for such use cases as estimating point-in-time portfolio balances. This value does not represent authoritative pricing information used by Anchorage Digital for any purpose. The price is fetched as of the present, and may be omitted in certain contexts where more structured pricing information is provided (e.g. quotes and trades). - `currentUSDValue` string — The result of `quantity * currentPrice`, rounded to the nearest cent. A unitless number implicitly denominated in dollars. See `currentPrice` for methodology and disclaimers. - `quantity` string, required — The numeric value of this amount, excluding units - `source` SourceResourceDetails — An object representing a resource capable of sending funds. Construction example: ``` { "id":"1c920f4241b78a1d483a29f3c24b6c4c", "type":"WALLET" } ``` - `id` string, required — The identifier of the resource - `type` 'VAULT' | 'WALLET', required — The type of the resource being referenced. Note that the VAULT type has been deprecated and WALLET should be used instead. - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'QUEUED', required — A string describing the status of the given transfer * IN_PROGRESS - This transfer is in progress and is not final. * COMPLETED - This transfer has been completed and is confirmed on the blockchain. * FAILED - This transfer has failed. Funds were not successfully transferred. * QUEUED - This transfer has been queued behind another transfer of the same asset. - `transferId` string, required — The transfer ID which can be used to reference this transfer in other queries - `transferMemo` string, nullable — A user-supplied description that will become the description of the subsequent transfer operation (optional) - `page` Page, required — Pagination info - `next` string, nullable — URL to use to query for the next page or null if no additional results are available ## Other responses - `400` — Bad Request - `401` — Unauthenticated - `403` — Forbidden - `404` — Not Found - `429` — Too Many Requests - `500` — Internal Server Error --- [API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)