Skip to content
Developer
Sign inSign up

List fee entries

List every fee, collection and adjustment behind your fee statement, newest first.

Every fee, collection and adjustment behind your statement, newest first. amount is a decimal string in US dollars, signed from your side: a fee adds to what you owe and a collection pays it down, as "-25.00" does. balance is what you owed right after the entry, written the same way.

Entry types

  • payment_fee value
    A successful payment's fee, its rate plus the flat fee, whoever paid it. payment_id names it.
  • wallet_plan value
    A month of your wallet plan. wallet_id and plan_month, from 1, name it.
  • collection value
    A payment's funds that went to 402pay. collection holds the coin, network, amount, 402pay's address and the transfer.
  • adjustment value
    A change 402pay made, with its note for you when there is one.
  • network_fee value
    A network fee 402pay paid for one of your sends, such as energy rented on Tron, passed on at cost.

Query

  • type string
    payment_fee, wallet_plan, collection, adjustment or network_fee.
  • limit integer
    Page size, from 1 to 100. Defaults to 25.
  • cursor string
    The next_cursor from the previous page. See pagination.

Errors

  • 400 invalid_request
    type has a value it can't take, or the cursor belongs to another list.
  • 403 permission_denied
    A restricted key without read access to payments.

Any request can also fail on its key or its body. See errors.

Request
curl "https://api.402pay.co/api/v1/billing/fees/entries?type=collection&limit=1" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"
Response200 OK
{  "data": [    {      "id": "fee_Eor0UAv0Ama0Pcnu",      "kind": "fee_entry",      "type": "collection",      "amount": "-25.00",      "currency": "USD",      "balance": "6.40",      "payment_id": "pmt_IEizRuSvGtJU0tPQ",      "checkout_id": "chk_Hq9bLRPRqpYqhWv6",      "wallet_id": null,      "plan_month": null,      "collection": {        "asset": "USDC",        "network": "solana",        "amount": "25.00",        "address": "7DmM84gY7ZokTyQcKydWauBdvwithGVG1pgDH44qWTG8",        "tx_hash": "a1ot1F4sVTnAMfnC2UwnMCxBkLGNrfBGuHsx2GAW5qFNTkSXMZdZ5SYjxToTw9ct5JvjzxixQbV18Y4ZcvAe7oE",        "explorer_url": "https://solscan.io/tx/a1ot1F4sVTnAMfnC2UwnMCxBkLGNrfBGuHsx2GAW5qFNTkSXMZdZ5SYjxToTw9ct5JvjzxixQbV18Y4ZcvAe7oE"      },      "note": null,      "created_at": "2026-09-29T12:00:00.000Z"    }  ],  "has_more": true,  "next_cursor": "fee_Eor0UAv0Ama0Pcnu"}