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.