---
title: "List Fee Configurations"
method: GET
path: "/sub_accounts/{id}/fee_configurations"
tags: ["Fee Configurations"]
---

# List Fee Configurations

`GET /sub_accounts/{id}/fee_configurations`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/sub_accounts/{id}/fee_configurations`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/sub_accounts/:id/fee_configurations/get.ts> (a function with typed inputs; its response is checked against the schema)

List all active Standard Fee Configurations for a sub account. Returns configurations where the current time is between `effective_start` and `effective_end` (or `effective_end` is null).

This endpoint supports [pagination](https://docs.justifi.tech/api-spec#section/Pagination).

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `after_cursor` string
- `before_cursor` string

## Headers

- `Authorization` string, required

## Response `200`

Successfully list fee configurations

- object
  - `id` number: the object id
  - `type` string: the object type, or array of objects
  - `data` StandardFeeConfiguration[]: the list of objects
    - `id` string: unique identifier for the fee configuration
    - `account_id` string, uuid: the sub account this configuration applies to
    - `platform_account_id` string, uuid, nullable: the platform account that created this configuration
    - `fee_type` 'processing_ecomm' | 'processing_card_present' | 'processing_ach' | 'processing_ach_expedited' | 'visa_brand_ecomm' | 'visa_brand_card_present' | 'mastercard_brand_ecomm' | 'mastercard_brand_card_present' | 'amex_brand_ecomm' | 'amex_brand_card_present' | 'discover_brand_ecomm' | 'discover_brand_card_present' | 'platform': the type of fee this configuration applies to: - `processing_ecomm` — card-not-present (online) payments - `processing_card_present` — card-present (terminal) payments - `processing_ach` — ACH payments - `processing_ach_expedited` — expedited ACH payments - `visa_brand_ecomm` — Visa online payments - `visa_brand_card_present` — Visa terminal payments - `mastercard_brand_ecomm` — Mastercard online payments - `mastercard_brand_card_present` — Mastercard terminal payments - `amex_brand_ecomm` — Amex online payments - `amex_brand_card_present` — Amex terminal payments - `discover_brand_ecomm` — Discover online payments - `discover_brand_card_present` — Discover terminal payments - `platform` — platform service fee applied to all payments
    - `variable_rate` number: percentage rate applied to the payment amount. `2.75` = 2.75%
    - `transaction_fee_cents` integer: flat fee in cents added to each transaction
    - `transaction_fee_currency` 'usd': currency of the transaction fee
    - `fee_cap_cents` integer, nullable: maximum fee amount in cents; if the calculated fee exceeds this, the cap is used instead
    - `effective_start` string, date-time: when this configuration takes effect (UTC)
    - `effective_end` string, date-time, nullable: when this configuration expires (UTC); `null` means it stays active indefinitely
  - `page_info` PageInfo
    - `end_cursor` string: the encoded id of the last record in the current list
    - `has_next` boolean: true if the collection contains records following the current list
    - `has_previous` boolean: true if the collection contains records ahead of the current list
    - `start_cursor` string: the encoded id of the first record in the current list

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)