# List Fees

Retrieve a list of Fee resources.

Filter fees by linked entity: You can filter fees by the entity that generated them using the linked_to query parameter:

- Transfer fees: ?linked_to=TRnErBfrHLgdAi3BqAkWLN27
- Authorization fees: ?linked_to=AUg8unYpnWBEY1AdVUDkdQYJ
- Split transfer fees: ?linked_to=split_transfer_split_transfer_97gaitUpcmzqjYYpQbei9j
- Compliance Form fees: ?linked_to=cf_uwErNm23TKYNEiqrEdJK59
- Payment Instrument fees: ?linked_to=PInVUXZLswZi6pdcK1T41MuE
- Merchant-specific fees: ?linked_to=MUwfZPNW3r4EqLMzwgr6txw4

{% admonition type="info" %}
Merchant-specific fees include monthly dues and assessments and any custom fees.
{% /admonition %}

To show fees charged to a specific entity during a period, pass the created_at.gte and created_at.lte query parameters.
- Example: ?merchant_id=MUeDVrf2ahuKc9Eg5TeZugvs&created_at.lte=2025-01-01&created_at.gte=2025-02-01

**Endpoint:** GET /fees  
**Security:** BasicAuth

## Header parameters:

- `Finix-Version` (string)  
    Specify the API version of your request. For more details, see Versioning.
    Example: "2022-02-01"

## Query parameters:

- `after_cursor` (string)  
    Return every resource created after the cursor value.

- `before_cursor` (string)  
    Return every resource created before the cursor value.

- `created_at.gte` (string)  
    Filter where created_at is after the given date.  
    Example: "2022-09-27T11:21:23"

- `created_at.lte` (string)  
    Filter where created_at is before the given date.  
    Example: "2026-09-27T11:21:23"

- `limit` (integer)  
    The numbers of items to return.  
    Example: 10

- `linked_to` (string)  
    The ID of the resource that generated the Fee.  
    Example: "TRrB2VG7H84LmRgSTkfR2Cb6"

- `merchant_id` (string)  
    The ID of the Merchant that was charged fees.  
    Example: "MUeDVrf2ahuKc9Eg5TeZugvs"

- `tags.key` (string)  
    Filter by the tag's key. For more information, see Tags.  
    Example: "card_type"

- `tags.value` (string)  
    Filter by the tag's value. For more information, see Tags.  
    Example: "business_card"

- `updated_at.gte` (string)  
    Filter where updated_at is after the given date.  
    Example: "2022-09-27T11:21:23"

- `updated_at.lte` (string)  
    Filter where updated_at is before the given date.  
    Example: "2026-09-27T11:21:23"

## Response 200 fields (application/json):

- `page` (object)  
    Details the page that's returned.

- `page.limit` (integer)  
    The number of entries to return.

- `page.next_cursor` (string,null)  
    The cursor to use for the next page of results.

- `_embedded` (object)

- `_embedded.fees` (array)

- `_embedded.fees.id` (string)  
    The ID of the resource.

- `_embedded.fees.created_at` (string)  
    Timestamp of when the object was created.

- `_embedded.fees.updated_at` (string)  
    Timestamp of when the object was last updated.

- `_embedded.fees.amount` (number)  
    Represents the total amount. The value may be returned as either:

- an integer (int32) in cents (e.g., 100 = $1.00), or
- a double for fractional amounts (e.g., 2.393).  
    Example: 2.393

- `_embedded.fees.application` (string)  
    ID of the Application the resource was created under.

- `_embedded.fees.category` (string,null)  
    The Fee category.  
    Enum: "PROCESSOR", "INTERCHANGE", "DUES_AND_ASSESSMENTS", "THIRD_PARTY_SERVICE_PROVIDER"

- `_embedded.fees.currency` (string)  
    ISO 4217 3-letter currency code.  
    Enum: "CAD", "USD"

- `_embedded.fees.display_name` (string,null)  
    It is used for subscription fees and allows free-form text to be passed from the subscription fee product. Note that this product is mostly deprecated.

- `_embedded.fees.fee_profile` (string)  
    The ID of the Fee Profile used to calculate fees for the Transfer related to this Fee. The specific Transfer is identified by the linked_to field.

- `_embedded.fees.fee_subtype` (string)  
    The subtype of the Fee.  
    Enum: "CUSTOM", "APPLICATION_FEE", "PLATFORM_FEE"

- `_embedded.fees.fee_type` (string)  
    The type of Fee. Finix may return more enums than those provided. Ensure your code accepts additional enums returned by Finix.
    Enum: "ACH_BASIS_POINTS", "ACH_CREDIT_RETURN_FIXED_FEE", "ACH_DEBIT_RETURN_FIXED_FEE", "ACH_FIXED", "ACH_MAX_FIXED", "ACH_NOTICE_OF_CHANGE_CREDIT_FIXED", "ACH_NOTICE_OF_CHANGE_DEBIT_FIXED", "AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS", "AMERICAN_EXPRESS_BASIS_POINTS", "AMERICAN_EXPRESS_FIXED", "AMERICAN_EXPRESS_INTERCHANGE", "ANCILLARY_FIXED_FEE_PRIMARY", "ANCILLARY_FIXED_FEE_SECONDARY", "APPLICATION_FEE", "CARD_BASIS_POINTS", "CARD_FIXED", "CARD_INTERCHANGE", "COMPLIANCE_FORMS_OVERDUE_FIXED", "CUSTOM", "DINERS_CLUB_BASIS_POINTS", "DINERS_CLUB_FIXED", "DINERS_CLUB_INTERCHANGE", "DISCOVER_ASSESSMENT_BASIS_POINTS", "DISCOVER_BASIS_POINTS", "DISCOVER_DATA_USAGE_FIXED", "DISCOVER_FIXED", "DISCOVER_INTERCHANGE", "DISCOVER_NETWORK_AUTHORIZATION_FIXED", "DISPUTE_FIXED_FEE", "DISPUTE_INQUIRY_FIXED_FEE", "EFT_MAX_FIXED", "GROSS_MONTHLY_FEES_ACH_BASIS_POINTS", "GROSS_MONTHLY_FEES_ACH_FIXED", "GROSS_MONTHLY_FEES_CARD_BASIS_POINTS", "GROSS_MONTHLY_FEES_CARD_FIXED", "GROSS_MONTHLY_FEES_EFT_BASIS_POINTS", "GROSS_MONTHLY_FEES_EFT_FIXED", "INVOICE_ACH_BASIS_POINTS", "INVOICE_ACH_FIXED", "INVOICE_ACH_MAX_FIXED", "INVOICE_CARD_BASIS_POINTS", "INVOICE_CARD_FIXED", "INVOICE_EFT_BASIS_POINTS", "INVOICE_EFT_FIXED", "INVOICE_EFT_MAX_FIXED", "JCB_BASIS_POINTS", "JCB_FIXED", "JCB_INTERCHANGE", "MASTERCARD_ACQUIRER_FEE_BASIS_POINTS", "MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS", "MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS", "MASTERCARD_BASIS_POINTS", "MASTERCARD_FIXED", "MASTERCARD_INTERCHANGE", "QUALIFIED_TIER_BASIS_POINTS_FEE", "QUALIFIED_TIER_FIXED_FEE", "SETTLEMENT_FUNDING_TRANSFER_ACH_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_ACH_CREDIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_ACH_DEBIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_ACH_FIXED", "SETTLEMENT_FUNDING_TRANSFER_ACH_MAX_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_EFT_CREDIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_DEBIT_RETURN_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_FIXED", "SETTLEMENT_FUNDING_TRANSFER_EFT_MAX_FIXED", "SETTLEMENT_FUNDING_TRANSFER_INSTANT_PAYOUT_CARD_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_INSTANT_PAYOUT_CARD_FIXED", "SETTLEMENT_FUNDING_TRANSFER_INSTANT_PAYOUT_CARD_MAX_FIXED", "SETTLEMENT_FUNDING_TRANSFER_NOC_CREDIT_FIXED", "SETTLEMENT_FUNDING_TRANSFER_NOC_DEBIT_FIXED", "SETTLEMENT_FUNDING_TRANSFER_SAME_DAY_ACH_BASIS_POINTS", "SETTLEMENT_FUNDING_TRANSFER_SAME_DAY_ACH_FIXED", "SETTLEMENT_FUNDING_TRANSFER_SAME_DAY_ACH_MAX_FIXED", "SUBSCRIPTION_ACH_BASIS_POINTS", "SUBSCRIPTION_ACH_FIXED", "SUBSCRIPTION_ACH_MAX_FIXED", "SUBSCRIPTION_CARD_BASIS_POINTS", "SUBSCRIPTION_CARD_FIXED", "SUBSCRIPTION_EFT_BASIS_POINTS", "SUBSCRIPTION_EFT_FIXED", "SUBSCRIPTION_EFT_MAX_FIXED", "SUPPLEMENTAL_FEE_FIXED", "VISA_ACQUIRER_PROCESSING_FIXED", "VISA_ASSESSMENT_BASIS_POINTS", "VISA_BASE_II_CREDIT_VOUCHER_FIXED", "VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED", "VISA_BASIS_POINTS", "VISA_CREDIT_VOUCHER_FIXED", "VISA_FIXED", "VISA_INTERCHANGE", "VISA_KILOBYTE_ACCESS_FIXED", "VISA_TRANSACTION_INTEGRITY_FIXED"

- `_embedded.fees.label` (string,null)  
    It is used for subscription fees and allows free-form text to be passed from the subscription fee product. Note that this product is mostly deprecated.

- `_embedded.fees.linked_id` (string)  
    The ID of the linked resource. Note that this field will be deprecated soon, use linked_to instead.

- `_embedded.fees.linked_to` (string)  
    The ID of the linked resource.

- `_embedded.fees.linked_type` (string)  
    The type of entity the Fee is linked to.  
    Enum: "TRANSFER", "AUTHORIZATION"

- `_embedded.fees.merchant` (string)  
    The ID of the Merchant resource that was charged the fee.

- `_embedded.fees.ready_to_settle_at` (string,null)  
    The timestamp indicating when the Transfer related to this Fee is ready to be settled. The specific Transfer is identified by the linked_to field.

- `_embedded.fees.tags` (object,null)  
    Include up to 50 key: value pairs to annotate requests with custom metadata.  
    - Maximum character length for individual keys is 40.
    - Maximum character length for individual values is 500.
(For example, order_number: 25, item_type: produce, department: sales)

- `_embedded.fees._links` (object)  
    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

- `_embedded.fees._links.self` (object)  
    The path to the Fee resource.

- `_embedded.fees._links.self.href` (string)

- `_embedded.fees._links.merchant` (object)  
    A link to the Merchant that the fee was debited from.

- `_embedded.fees._links.merchant.href` (string)

- `_embedded.fees._links.transfer` (object)  
    A link to the Transfer that generated the Fee.

- `_embedded.fees._links.transfer.href` (string)

- `_links` (object)

- `_links.self` (object)  
    Link to the resource that was used in the request.

- `_links.self.href` (string)

- `_links.next` (object)  
    Link to the next page of entries.

- `_links.next.href` (string)

## Response 401 fields (application/json):

- `total` (integer, required)  
    Total number of errors returned.

- `_embedded` (object, required)  
    Container for embedded error objects.

- `_embedded.errors` (array)  
    List of individual error objects.

- `_embedded.errors.code` (string)  
    The error code. The UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)  
    A log reference identifier for the error, useful for debugging and support purposes.

- `_embedded.errors.message` (string)  
    A human-friendly error message.

- `_embedded.errors._links` (object)  
    Links related to this error.

- `_embedded.errors._links.self` (object)  
    Link to the resource related to the error.

- `_embedded.errors._links.self.href` (string)  
    URL of the related resource.

## Response 403 fields (application/json):

- `total` (integer, required)  
    Total number of errors returned.

- `_embedded` (object, required)  
    Container for embedded error objects.

- `_embedded.errors` (array)  
    List of individual error objects.

- `_embedded.errors.code` (string)  
    The error code. The UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)  
    A log reference identifier for the error, useful for debugging and support purposes.

- `_embedded.errors.message` (string)  
    A human-friendly error message.

- `_embedded.errors._links` (object)  
    Links related to this error.

- `_embedded.errors._links.self` (object)  
    Link to the resource related to the error.

- `_embedded.errors._links.self.href` (string)  
    URL of the related resource.

## Response 406 fields (application/json):

- `total` (integer, required)  
    Total number of errors returned.

- `_embedded` (object, required)  
    Container for embedded error objects.

- `_embedded.errors` (array)  
    List of individual error objects.

- `_embedded.errors.code` (string)  
    The error code. The UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)  
    A log reference identifier for the error, useful for debugging and support purposes.

- `_embedded.errors.message` (string)  
    A human-friendly error message.

- `_embedded.errors._links` (object)  
    Links related to this error.

- `_embedded.errors._links.self` (object)  
    Link to the resource related to the error.

- `_embedded.errors._links.self.href` (string)  
    URL of the related resource.

## Response 422 fields (application/json):

- `total` (integer, required)  
    Total number of errors returned.

- `_embedded` (object, required)  
    Container for embedded error objects.

- `_embedded.errors` (array)  
    List of individual error objects.

- `_embedded.errors.code` (string)  
    The error code. The UNKNOWN error code is returned for a 401 Unauthorized or 403 Forbidden request.

- `_embedded.errors.logref` (string)  
    A log reference identifier for the error, useful for debugging and support purposes.

- `_embedded.errors.message` (string)  
    A human-friendly error message.

- `_embedded.errors._links` (object)  
    Links related to this error.

- `_embedded.errors._links.self` (object)  
    Link to the resource related to the error.

- `_embedded.errors._links.self.href` (string)  
    URL of the related resource.