List Fees

Suggest Edits

---

Overview

Retrieve a list of Fee resources linked to a specific Transfer or Authorization. Fees represent charges levied against a merchant, typically generated automatically by payment transactions based on the fee profile configuration.

---

Resource Access

Production (api.ahrvo.network)

GET https://api.ahrvo.network/payments/na/fees

Staging (gateway.ahrvo.network)

GET http://gateway.ahrvo.network/payments/na/fees

---

Arguments

Attribute	Mandatory / Optional	Description
Finix-Version	Mandatory	Specify the API version (e.g., 2022-02-01)
linked_to	Mandatory	The ID of the TRANSFER or AUTHORIZATION that generated the fees
limit	Optional	The number of items to return (default: 5)
after_cursor	Optional	Return every resource created after the cursor value

---

Example Request

curl -X GET "https://gateway.ahrvo.network/payments/na/fees?linked_to=TRxxxxxxxxxxxxxxxxxx&limit=10" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64_encoded_credentials>" \
  -H "Finix-Version: 2022-02-01"

---

Example Response

{
  "_embedded": {
    "fees": [
      {
        "id": "FExxxxxxxxxxxxxxxxxx",
        "created_at": "2025-12-10T10:30:00Z",
        "updated_at": "2025-12-10T10:30:00Z",
        "amount": 275,
        "currency": "USD",
        "category": "PROCESSOR",
        "display_name": "Card Processing Fee",
        "fee_subtype": "PLATFORM_FEE",
        "fee_type": "CARD_BASIS_POINTS",
        "label": "card_processing",
        "linked_to": "TRxxxxxxxxxxxxxxxxxx",
        "linked_type": "TRANSFER",
        "merchant": "MRxxxxxxxxxxxxxxxxxx",
        "tags": {},
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/fees/FExxxxxxxxxxxxxxxxxx"
          },
          "transfer": {
            "href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
          },
          "merchant": {
            "href": "https://api.ahrvo.network/payments/na/merchants/MRxxxxxxxxxxxxxxxxxx"
          }
        }
      },
      {
        "id": "FEyyyyyyyyyyyyyyyyyy",
        "created_at": "2025-12-10T10:30:00Z",
        "updated_at": "2025-12-10T10:30:00Z",
        "amount": 10,
        "currency": "USD",
        "category": "PROCESSOR",
        "display_name": "Card Fixed Fee",
        "fee_subtype": "PLATFORM_FEE",
        "fee_type": "CARD_FIXED",
        "label": "card_fixed",
        "linked_to": "TRxxxxxxxxxxxxxxxxxx",
        "linked_type": "TRANSFER",
        "merchant": "MRxxxxxxxxxxxxxxxxxx",
        "tags": {},
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/fees/FEyyyyyyyyyyyyyyyyyy"
          },
          "transfer": {
            "href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
          }
        }
      },
      {
        "id": "FEzzzzzzzzzzzzzzzzzz",
        "created_at": "2025-12-10T10:30:00Z",
        "updated_at": "2025-12-10T10:30:00Z",
        "amount": 50,
        "currency": "USD",
        "category": "PROCESSOR",
        "display_name": "Interchange Fee",
        "fee_subtype": "INTERCHANGE_FEE",
        "fee_type": "CARD_BASIS_POINTS",
        "label": "interchange",
        "linked_to": "TRxxxxxxxxxxxxxxxxxx",
        "linked_type": "TRANSFER",
        "merchant": "MRxxxxxxxxxxxxxxxxxx",
        "tags": {},
        "_links": {
          "self": {
            "href": "https://api.ahrvo.network/payments/na/fees/FEzzzzzzzzzzzzzzzzzz"
          }
        }
      }
    ]
  },
  "page": {
    "offset": 0,
    "limit": 10,
    "count": 3
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/fees?linked_to=TRxxxxxxxxxxxxxxxxxx&limit=10"
    }
  }
}

---

Understanding Fee Types

Fee Type Values

• CARD_BASIS_POINTS: Percentage-based card processing fee
• CARD_FIXED: Fixed-amount card processing fee
• ACH_BASIS_POINTS: Percentage-based ACH fee
• ACH_FIXED: Fixed-amount ACH fee
• CUSTOM: Custom one-time fee

Fee Subtype Values

• PLATFORM_FEE: Standard platform processing fee
• INTERCHANGE_FEE: Card network interchange fee
• CUSTOM: Custom fee created manually

Linked Type Values

• TRANSFER: Fee generated from a transfer
• AUTHORIZATION: Fee generated from an authorization

---

API Documentation

---