comecerodocs

Get a fee

GET
/fees/{fee_id}

Gets one fee. Send expand=transaction to get the payment or refund it is on. Secret and trusted tokens may call it; a limited token may not (403).

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

fee_id*string

The fee id.

Query Parameters

timezone?string

An IANA time zone name, such as America/New_York or UTC. It sets how date_start and date_end are read and the time zone of every date in the response. The default is the account's time zone (Settings, Technical), or UTC when it has none. A name that is not known is a 400.

expand?string

Comma-separated child objects to return in full instead of as a URL, for example customer,payments. Use dot notation for nested objects (items.product), up to four levels deep. A single object takes up to 12 paths; a list takes up to 2, applied to every item. Extra paths are dropped without an error. See Expanding objects.

show?string

Comma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

hide?string

Comma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

formatted?boolean

When true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.

Defaultfalse

Response Body

The fee.

application/json
  1. response

A fee Comecero charges your account, for a transaction (a payment, refund, decline or chargeback) or for the service (a monthly or annual plan). Fees are made by Comecero; you cannot create them. Fees with the same accounting_id are billed together.

object?"fee"

Always fee.

Value in"fee"
url?string

The URL of this fee in the API.

Formaturi
fee_id?string

The fee id.

date_created?string

When the fee was charged.

Formatdate-time
date_modified?string

When the fee last changed.

Formatdate-time
test?boolean

true for a test mode fee. Test fees are never billed.

account_id?string

The account charged.

fixed_amount?number

The fixed part of the fee, in currency.

percentage?number

The percentage rate, for example 2.9 for 2.9%.

percentage_amount?number

The percentage part of the fee, in currency.

total?number

The whole fee, fixed_amount plus percentage_amount, in currency.

currency?string

The ISO 4217 currency of the amounts.

type?string

What the fee is for. Transaction fees: payment_completed, refund_completed, auth, zero_auth, capture, void, decline, chargeback, plus contract fees fx_conversion, international_card and payout. Service fees: platform_monthly, platform_annual, support_annual, miscellaneous.

Value in"payment_completed""refund_completed""auth""zero_auth""capture""void""decline""chargeback""fx_conversion""international_card""payout""platform_monthly""platform_annual""support_annual""miscellaneous"
category?string

transaction for a fee on a payment or refund, operation for a service fee.

Value in"transaction""operation"
collected?boolean

true when the fee was already taken from the money by Comecero Express Payments. It is a record only and is not on any bill.

description?|

What the fee is, in words.

transaction_type?|

payment or refund when the fee is on a transaction, otherwise null.

Value in"payment""refund"null
created_by?|

Who made the fee by hand. Only returned to Comecero staff tokens.

transaction?||

The payment or refund the fee is on: its URL, or the full object with expand=transaction. Left out when the fee is on no transaction or the token may not read it.

contract?|

The URL of the contract whose prices set this fee, or null when no contract was in effect. Left out when the token may not read contracts.

accounting_id?|

The billing period the fee is billed in, for example C-AB1234R261130USD (account, R for receivable, period end date as YYMMDD, currency). null on a collected fee.

formatted?

Amounts and dates as display text. Only returned with formatted=true.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/fees/string'
Example Response
{  "object": "fee",  "url": "https://api.comecero.com/api/v1/fees/1102611073850FEp6Vb2Qs",  "fee_id": "1102611073850FEp6Vb2Qs",  "date_created": "2026-11-07T14:32:10Z",  "date_modified": "2026-11-07T14:32:10Z",  "test": true,  "account_id": "AB1234",  "fixed_amount": 0.3,  "percentage": 2.9,  "percentage_amount": 2.9,  "total": 3.2,  "currency": "USD",  "type": "payment_completed",  "category": "transaction",  "collected": false,  "description": "Payment completed",  "transaction_type": "payment",  "transaction": "https://api.comecero.com/api/v1/payments/1102611073840PAz3Tq9Xc",  "contract": null,  "accounting_id": "C-AB1234R261130USD"}