v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB
Pricing

List Partner Fees

List partner fees for an account.

  • On a main account: returns its default fees. Set include_sub_accounts=true to also include fees configured on its sub-accounts.
  • On a sub-account: returns that sub-account's fees.

Provide the external_id query parameter to look up a single fee by the external_id used when it was created (other filters are ignored).

get/v1/accounts/{account_id}/partner-fees

Path parameters

account_idstring required

Account ID (main or sub-account)

Query parameters

external_idstring

Partner-supplied external_id request value (UUID) used to make a create request idempotent. Validated at the API boundary and stored on the resource as an external identifier.

Example:550e8400-e29b-41d4-a716-446655440000

Look up a single fee by the external_id used when it was created. When set, other filters are ignored and at most one item is returned.

include_sub_accountsboolean

When the path account is a main account, set true to also include fees configured on its sub-accounts. Ignored for sub-account requests.

fee_type'FIAT_DEPOSIT' | 'FIAT_WITHDRAWAL' | 'CRYPTO_WITHDRAWAL' | 'CONVERSION'

Partner fee transaction type.

Filter by fee type

created_afterstring
Example:2025-08-21T07:56:57.981Z

Only fees created at or after this time (RFC3339/ISO 8601)

created_beforestring
Example:2025-08-21T07:56:57.981Z

Only fees created at or before this time (RFC3339/ISO 8601)

sort_order'ASC' | 'DESC'

Sort order by create time (ASC: oldest first, DESC: newest first; default DESC)

pageinteger

Page number (starts from 1, default: 1)

sizeinteger

Number of items per page (1-100, default: 10)

{
  "page": 1,
  "size": 10
}

Response

totalinteger nullable

Total number of fees matching the filters (across all pages)

Example response

{
  "items": [
    {
      "fee_id": "e9ece207-8fd6-400e-872b-409701e57b74",
      "fee": {
        "currency": "USD",
        "payment_rail": "US_FEDWIRE",
        "rate": "0.001",
        "fixed": "0.5"
      },
      "created_at": "2026-06-11T08:30:00Z",
      "modified_at": "2026-06-11T08:30:00Z"
    }
  ],
  "total": 42
}