listTransfers

Circle Mint

Core Functionality

Balances

Payouts

Wires

CBIT

PIX

Transfers

Addresses

Deposits

Accounts API

Wallets

Transfers

API Overview

Health

Management

Encryption

Subscriptions

Stablecoins

Channels

Payments API

Payments

Pull Crypto Payments

Crypto Payment Intents

Cards

Payment Tokens

Settlements

Chargebacks

Balances

Checkout Sessions

Payouts API

Payouts

Crypto Address Book

Crypto Exchange Rates

List all transfers

GEThttps://api.circle.com/v1/transfers

Searches for transfers involving the provided wallets. If no wallet ids are provided, searches all wallets associated with your Circle API 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.

Query parameters

walletId

string

Unique identifier for the source or destination wallet of transfers, if any. May not be used in conjunction with destinationWalletId or sourceWalletId. Useful for fetching all transfers related to a wallet.

sourceWalletId

string

Unique identifier for the source wallet of transfers, if any.

destinationWalletId

string

Unique identifier for the destination wallet of transfers, if any.

returnIdentities

boolean

Specify if you would like to see identities in the response. Restricts maximum returned items to 5. By default returnIdentities is false, resulting in the response not returning data.source.identities.

from

date-time

Queries items created since the specified date-time (inclusive).

date-time

Queries items created before the specified date-time (inclusive).

pageBefore

string

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.

pageAfter

string

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.

pageSize

integer

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.

Response

200ListTransfersResponse

Response Body

object

data

array of objects

Show 9 properties

string

Required

Unique system generated identifier for the entity.

source

object

Required

A source of funds.

option 1: object

Show 3 properties

type

string

Required

string

Required

The id of the wallet.

identities

array of objects

Show 3 properties

type

string

Required

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.

name

string

Required

Full name of the identity.

addresses

array of objects

Required

Show 6 properties

line1

string

Required

Line one of the street address.

line2

string

Line two of the street address.

city

string

Required

City portion of the address.

district

string

Required

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.

postalCode

string

Required

Postal / ZIP code of the address.

country

string

Required

Country portion of the address. Formatted as a two-letter country code specified in ISO 3166-1 alpha-2.

option 2: object

Show 3 properties

type

string

Required

chain

string

Required

A blockchain that a given currency is available on.

identities

array of objects

Show 3 properties

type

string

Required

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.

name

string

Required

Full name of the identity.

addresses

array of objects

Required

Show 6 properties

line1

string

Required

Line one of the street address.

line2

string

Line two of the street address.

city

string

Required

City portion of the address.

district

string

Required

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.

postalCode

string

Required

Postal / ZIP code of the address.

country

string

Required

Country portion of the address. Formatted as a two-letter country code specified in ISO 3166-1 alpha-2.

destination

object

Required

A destination of funds.

option 1: object

Show 4 properties

type

string

Required

address

string

Required

An alphanumeric string representing a blockchain address. Will be in different formats for different chains. It is important to preserve the exact formatting and capitalization of the address.

addressTag

string

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.

chain

string

Required

A blockchain that a given currency is available on.

option 2: object

Show 4 properties

amount

object

Required

Show 2 properties

fees

array of objects

An array of fees applied to a transaction. This is only available when there is at least one non-zero fee.

Show 3 properties

transactionHash

string

A hash that uniquely identifies the onchain transaction. This is only available where either source or destination are of type blockchain.

status

string

Required

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.

errorCode

string

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

createDate

string

The create date of the transfer.

401NotAuthorized

RequestChoose a language

ResponseChoose an example

1{
2  "data": [
3    {
4      "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
5      "source": {
6        "type": "wallet",
7        "id": "12345",
8        "identities": [
9          {
10            "type": "individual",
11            "name": "Satoshi Nakamoto",
12            "addresses": [
13              {
14                "line1": "100 Money Street",
15                "line2": "Suite 1",
16                "city": "Boston",
17                "district": "MA",
18                "postalCode": "01234",
19                "country": "US"
20              }
21            ]
22          }
23        ]
24      },
25      "destination": {
26        "type": "blockchain",
27        "address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
28        "addressTag": "123456789",
29        "chain": "ALGO"
30      },
31      "amount": {
32        "amount": "3.14",
33        "currency": "USD"
34      },
35      "fees": [
36        {
37          "amount": "10.00",
38          "currency": "USD",
39          "type": "network"
40        }
41      ],
42      "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
43      "status": "pending",
44      "errorCode": "transfer_failed",
45      "createDate": ""
46    }
47  ]
48}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy