FIfinix
Fees
Split Transfers

List Fees

Changed on

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
get/fees

Request

Query parameters

after_cursorstring

Return every resource created after the cursor value.

before_cursorstring

Return every resource created before the cursor value.

created_at.gtestring date-time
Example:2022-09-27T11:21:23

Filter where created_at is after the given date.

created_at.ltestring date-time
Example:2026-09-27T11:21:23

Filter where created_at is before the given date.

limitinteger
Example:10

The numbers of items to return.

linked_tostring

The ID of the resource that generated the Fee.

merchant_idstring

The ID of the Merchant that was charged fees.

tags.keystring
Example:card_type

Filter by the tag's key. For more information, see Tags.

tags.valuestring
Example:business_card

Filter by the tag's value. For more information, see Tags.

updated_at.gtestring date-time
Example:2022-09-27T11:21:23

Filter where updated_at is after the given date.

updated_at.ltestring date-time
Example:2026-09-27T11:21:23

Filter where updated_at is before the given date.

Headers

Finix-Versionstring
Example:2022-02-01

Specify the API version of your request. For more details, see Versioning.

Response

List of Fee resources

Example response

{
  "_embedded": {
    "fees": [
      {
        "amount": 2.393
      }
    ]
  }
}

Changes

  • 6e62a6816400Revision changes
    • warning

      added the new ACH_VALIDATION_PLAID_FIXED enum value to the /// response property for the response status

    • warning

      added the new AFTERPAY_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new AFTERPAY_FIXED enum value to the /// response property for the response status

    • warning

      added the new AMERICAN_EXPRESS_EXTERNALLY_FUNDED_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new AMERICAN_EXPRESS_EXTERNALLY_FUNDED_FIXED enum value to the /// response property for the response status

    • warning

      added the new CARD_ACCOUNT_UPDATER_FIXED enum value to the /// response property for the response status

    • warning

      added the new CARD_CROSS_BORDER_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new CARD_CROSS_BORDER_FIXED_FEE enum value to the /// response property for the response status

    • warning

      added the new CARD_EXTERNALLY_FUNDED_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new CARD_EXTERNALLY_FUNDED_FIXED enum value to the /// response property for the response status

    • warning

      added the new CARD_NAME_VERIFICATION_FIXED enum value to the /// response property for the response status

    • warning

      added the new CARD_NETWORK_TOKEN_FIXED enum value to the /// response property for the response status

    • warning

      added the new CASH_APP_PAY_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new CASH_APP_PAY_FIXED enum value to the /// response property for the response status

    • warning

      added the new COMPLIANCE_FORM_OVERDUE_FIXED enum value to the /// response property for the response status

    • warning

      added the new DISCOVER_EXTERNALLY_FUNDED_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new DISCOVER_EXTERNALLY_FUNDED_FIXED enum value to the /// response property for the response status

    • warning

      added the new EFT_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new EFT_CREDIT_RETURN_FIXED_FEE enum value to the /// response property for the response status

    • warning

      added the new EFT_DEBIT_RETURN_FIXED_FEE enum value to the /// response property for the response status

    • warning

      added the new EFT_FIXED enum value to the /// response property for the response status

    • warning

      added the new EFT_VALIDATION_PLAID_FIXED enum value to the /// response property for the response status

    • warning

      added the new INTERAC_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new INTERAC_FIXED enum value to the /// response property for the response status

    • warning

      added the new PAYMENT_INSTRUMENT_TOKENIZATION_FIXED enum value to the /// response property for the response status

    • warning

      added the new THIRD_PARTY_GATEWAY_CYBERSOURCE_BASIS_POINTS enum value to the /// response property for the response status

    • warning

      added the new THIRD_PARTY_GATEWAY_CYBERSOURCE_FIXED enum value to the /// response property for the response status

    • info

      removed the AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS enum value from the /// response property for the response status

    • info

      removed the COMPLIANCE_FORMS_OVERDUE_FIXED enum value from the /// response property for the response status

    • info

      removed the DISCOVER_ASSESSMENT_BASIS_POINTS enum value from the /// response property for the response status

    • info

      removed the MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS enum value from the /// response property for the response status

    • info

      removed the MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS enum value from the /// response property for the response status

    • info

      removed the VISA_ASSESSMENT_BASIS_POINTS enum value from the /// response property for the response status

    • info

      removed the VISA_TRANSACTION_INTEGRITY_FIXED enum value from the /// response property for the response status

  • 9db82db717c5Revision changes
    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • warning

      added the new SPLIT_TRANSFER enum value to the /// response property for the response status