Transfers

Get all transfers

Changed on
get/transfers

Request

  • Base URL
    https://api.bridge.xyz/v0
  • URL
    https://api.bridge.xyz/v0/transfers
  • Auth
    API key in header Api-Key

Query parameters

limitinteger

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

starting_afterstring

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_beforestring

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_hashstring

The hash of the transaction

updated_after_msinteger

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

updated_before_msinteger

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

template_idstring

A UUID that uniquely identifies a resource

This is a template id. If this is specified, the transfers with the specified template id will be returned.

state'awaiting_funds' | 'funds_received' | 'payment_submitted' | 'payment_processed' | 'in_review' | 'kyc_required' | 'kyc_in_review' | 'developer_kyb_required' | 'canceled' | 'error' | 'returned' | 'refund_in_flight' | 'refund_failed' | 'refunded' | 'undeliverable'

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

Response

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

countinteger required

The number of transfers returned

Example response

{
  "data": [
    {
      "source_deposit_instructions": {
        "payment_rail": "wire",
        "amount": "75.0",
        "currency": "usd",
        "deposit_message": "BVI7depositmessage",
        "bank_name": "Bank name",
        "bank_address": "Bank address",
        "bank_routing_number": "123456789",
        "bank_account_number": "1234567890",
        "bank_beneficiary_name": "Bank beneficiary",
        "bank_beneficiary_address": "Bank beneficiary address"
      },
      "return_details": {
        "risk_rejection_reason": "Exceeds Transaction Limits"
      }
    }
  ]
}

Changes

    • breaking

      the response property // became optional for the status

    • breaking

      added to the // response property oneOf list for the response status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      added the new fednow enum value to the /////// response property for the response status

    • warning

      added the new linea enum value to the /////// response property for the response status

    • warning

      added the new linea enum value to the //// response property for the response status

    • warning

      added the new linea enum value to the /////// response property for the response status

    • warning

      added the new linea enum value to the //// response property for the response status

    • warning

      added the new linea enum value to the //// response property for the response status

    • warning

      added the new ousd enum value to the /////// response property for the response status

    • warning

      added the new ousd enum value to the //// response property for the response status

    • warning

      added the new ousd enum value to the /////// response property for the response status

    • warning

      added the new ousd enum value to the //// response property for the response status

    • warning

      added the new path_usd enum value to the /////// response property for the response status

    • warning

      added the new path_usd enum value to the //// response property for the response status

    • warning

      added the new path_usd enum value to the /////// response property for the response status

    • warning

      added the new path_usd enum value to the //// response property for the response status

    • warning

      added the new usdl_linea enum value to the /////// response property for the response status

    • warning

      added the new usdl_linea enum value to the //// response property for the response status

    • warning

      added the new usdl_linea enum value to the /////// response property for the response status

    • warning

      added the new usdl_linea enum value to the //// response property for the response status

    • warning

      added the new xdc enum value to the /////// response property for the response status

    • warning

      added the new xdc enum value to the //// response property for the response status

    • warning

      added the new xdc enum value to the /////// response property for the response status

    • warning

      added the new xdc enum value to the //// response property for the response status

    • warning

      added the new xdc enum value to the //// response property for the response status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      the response optional property /// became read-only for the status

    • info

      removed subschema #2 from the // response property allOf list for the response status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status