GET
/
customers
/
{customerID}
/
transfers
Get all transfers
curl --request GET \
  --url https://api.bridge.xyz/v0/customers/{customerID}/transfers \
  --header 'Api-Key: <api-key>'
{
  "count": 2,
  "data": [
    {
      "id": "transfer_456",
      "client_reference_id": "client_transfer_id_456",
      "state": "funds_received",
      "on_behalf_of": "cust_123",
      "amount": "500.25",
      "developer_fee": "0.0",
      "source": {
        "payment_rail": "ach",
        "currency": "usd",
        "external_account_id": "ext_123"
      },
      "destination": {
        "payment_rail": "ethereum",
        "currency": "usdc",
        "to_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
      },
      "receipt": {
        "initial_amount": "500.25",
        "developer_fee": "0.0",
        "exchange_fee": "0.0",
        "subtotal_amount": "500.25",
        "gas_fee": "0.0",
        "final_amount": "500.25",
        "destination_tx_hash": "0xdeadbeef",
        "url": "https://dashboard.bridge.xyz/transaction/00000000-0000-0000-0000-000000000000/receipt/00000000-0000-0000-0000-000000000000"
      },
      "created_at": "2020-01-02T00:00:00.000Z",
      "updated_at": "2020-01-03T00:00:00.000Z"
    },
    {
      "id": "transfer_123",
      "client_reference_id": "client_transfer_id_123",
      "state": "awaiting_funds",
      "on_behalf_of": "cust_123",
      "amount": "75.0",
      "developer_fee": "0.0",
      "source": {
        "payment_rail": "ethereum",
        "currency": "usdc",
        "from_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F"
      },
      "destination": {
        "payment_rail": "ach",
        "currency": "usd",
        "external_account_id": "ext_123"
      },
      "source_deposit_instructions": {
        "payment_rail": "ethereum",
        "amount": "75.0",
        "currency": "usdc",
        "from_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "to_address": "0xb794f5ea0ba39494ce839613fffba74279579268"
      },
      "receipt": {
        "initial_amount": "75.0",
        "developer_fee": "0.0",
        "exchange_fee": "0.0",
        "subtotal_amount": "75.0",
        "gas_fe": "0.0",
        "final_amount": "75.0",
        "url": "https://dashboard.bridge.xyz/transaction/00000000-0000-0000-0000-000000000000/receipt/00000000-0000-0000-0000-000000000000"
      },
      "created_at": "2020-01-01T00:00:00.000Z",
      "updated_at": "2020-01-02T00:00:00.000Z"
    }
  ]
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
customerID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Query Parameters

​
limit
integer

The number of items to return (default of 10, max of 100)

​
starting_after
string

This is a transfer id. If this is specified, the next page that starts with a transfer right AFTER the specified transfer id on the transfer timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that transfers older than the specified transfer id will be returned (shouldn't be set if ending_before is set)

​
ending_before
string

This is a transfer id. If this is specified, the previous page that ends with a transfer right BEFORE the specified transfer id on the transfer timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that transfers newer than the specified transfer id will be returned (shouldn't be set if starting_after is set)

​
tx_hash
string

The hash of the transaction

​
updated_after_ms
integer

This is a unix timestamp in milliseconds. If this is specified, objects updated AFTER the specified timestamp will be returned

​
updated_before_ms
integer

This is a unix timestamp in milliseconds. If this is specified, objects updated BEFORE the specified timestamp will be returned

​
state
enum<string>

Filter transfers by their external state. See Transfer States for more details.

Available options:
awaiting_funds,
funds_received,
payment_submitted,
payment_processed,
in_review,
kyc_required,
kyc_in_review,
developer_kyb_required,
canceled,
error,
returned,
refunded,
undeliverable

Response

200
application/json

List of transfers (the returned list is empty if none found)

The response is of type object.