---
title: "List Partner Fees"
method: GET
path: "/v1/accounts/{account_id}/partner-fees"
tags: ["Pricing"]
---

# List Partner Fees

`GET /v1/accounts/{account_id}/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).

## Path parameters

- `account_id` string, required

## Query parameters

- `external_id` string — 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.
- `include_sub_accounts` boolean
- `fee_type` 'FIAT_DEPOSIT' | 'FIAT_WITHDRAWAL' | 'CRYPTO_WITHDRAWAL' | 'CONVERSION' — Partner fee transaction type.
- `created_after` string
- `created_before` string
- `sort_order` 'ASC' | 'DESC'
- `pagination` object, required — Pagination query parameters. Two query parameter formats are supported: - Flat format (recommended): `?page=1&size=10` - Nested format: `?pagination=page=1&size=10` Both formats are functionally equivalent. We recommend using the flat format.
  - `page` integer — Page number (starts from 1, default: 1)
  - `size` integer — Number of items per page (1-100, default: 10)

## Response `200`

- PartnerFeeListResponse
  - `items` PartnerFeeResponse[], required
    - `fee_id` string, required — Partner fee ID exposed by OpenAPI.
    - `account_id` string, required
    - `fee` union, required — Fee definition of a partner fee, discriminated by `fee_type`.
      - object
        - `currency` 'USD', nullable — Fiat currency to scope this deposit fee. Omit in requests or expect `null` in responses to apply to all fiat deposit currencies.
        - `payment_rail` 'US_ACH' | 'US_FEDWIRE' | 'US_RTP' | 'SWIFT', nullable — Fiat payment rail to scope this fee. Omit in requests or expect `null` in responses to apply to all fiat deposit rails.
        - `rate` string, required — Percentage rate as a decimal, e.g. 0.001 = 0.1%. Must be >= 0 and < 1, with at most 5 decimal places. Computed fees are rounded up (away from zero) at the asset scale, so a configured fee never rounds to zero.
        - `fixed` string — Fixed fee in the currency unit; defaults to 0. At most 5 decimal places.
        - `fee_type` 'FIAT_DEPOSIT', required
      - object
        - `currency` 'USD', nullable — Fiat currency to scope this withdrawal fee. Omit in requests or expect `null` in responses to apply to all fiat withdrawal currencies.
        - `payment_rail` 'US_ACH' | 'US_FEDWIRE' | 'US_RTP' | 'SWIFT', nullable — Fiat payment rail to scope this fee. Omit in requests or expect `null` in responses to apply to all fiat withdrawal rails.
        - `rate` string, required — Percentage rate as a decimal, e.g. 0.001 = 0.1%. Must be >= 0 and < 1, with at most 5 decimal places. Computed fees are rounded up (away from zero) at the asset scale, so a configured fee never rounds to zero.
        - `fixed` string — Fixed fee in the currency unit; defaults to 0. At most 5 decimal places.
        - `fee_type` 'FIAT_WITHDRAWAL', required
      - object
        - `token` 'USDC' | 'USDT' | 'PYUSD' | 'RLUSD' | 'USDG' | 'USDP' | '1USD' | 'AUSD' | 'DAI' | 'EURC' | 'MXNB' | 'MEXAS' | 'GYEN' | 'BRL1' | 'BRLA' | 'COPM' | 'USTB' | 'BTC', nullable — Crypto token to scope this withdrawal fee. Omit in requests or expect `null` in responses to apply to all crypto tokens.
        - `network` 'AVALANCHE' | 'ETHEREUM' | 'POLYGON' | 'BNBCHAIN' | 'BASE' | 'ARBITRUM' | 'SOLANA' | 'TRON' | 'ONE_MONEY' | 'BITCOIN', nullable — Blockchain network to scope this withdrawal fee. Omit in requests or expect `null` in responses to apply to all supported crypto networks for the selected token.
        - `rate` string, required — Percentage rate as a decimal, e.g. 0.001 = 0.1%. Must be >= 0 and < 1, with at most 5 decimal places. Computed fees are rounded up (away from zero) at the asset scale, so a configured fee never rounds to zero.
        - `fixed` string — Fixed fee in the token unit; defaults to 0. At most 5 decimal places.
        - `fee_type` 'CRYPTO_WITHDRAWAL', required
      - object — Conversion fee definition.
        - `from_asset` string, nullable — Source asset of the conversion. Omit or use `null` to match any source asset. Omitting both `from_asset` and `to_asset` applies to all pairs.
        - `to_asset` string, nullable — Target asset of the conversion. Omit or use `null` to match any target asset. Omitting both `from_asset` and `to_asset` applies to all pairs.
        - `rate` string, required — Rate for the `from_asset` -> `to_asset` direction, e.g. 0.001 = 0.1%. Must be >= 0 and < 1, with at most 5 decimal places. Applies to that direction for every matched pair when either asset is omitted. Computed fees are rounded up (away from zero) at the asset scale, so a configured fee never rounds to zero.
        - `reverse_rate` string — Rate for the opposite `to_asset` -> `from_asset` direction; defaults to 0 (no fee). Must be >= 0 and < 1, with at most 5 decimal places.
        - `from_asset_fixed` string — Fixed fee in `from_asset` units; defaults to 0. At most 5 decimal places. Must be 0 when `from_asset` is omitted.
        - `to_asset_fixed` string — Fixed fee in `to_asset` units; defaults to 0. At most 5 decimal places. Must be 0 when `to_asset` is omitted.
        - `fee_type` 'CONVERSION', required
    - `created_at` string, required — Fee creation timestamp (ISO 8601)
    - `modified_at` string, required — Last modification timestamp (ISO 8601)
  - `total` integer, nullable — Total number of fees matching the filters (across all pages)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `405` — Method Not Allowed
- `500` — Internal Server Error

---

[API](https://skmtc.net/1money/apis/1money-openapi.md) · [All operations](https://skmtc.net/1money/apis/1money-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/1money/1money-openapi/revisions/aa2718d28cb5/schema)