Mono Colombia
GuidesAPI reference

Lists fees

Lists the fees charged on your accounts, newest first, paginated. Use it to reconcile what was charged, when, on which account and under which rule.

The two sides

Two kinds of fees appear here, told apart by owner:

  • tenant — the fees you charge your own users, debited on their subaccounts and priced with your fee policies. They are your revenue.
  • mono — the fees Mono charges you for using the platform, debited on your own accounts. They are your cost.

Omit owner to list both.

What each fee carries

The policy that priced it, the rule and the calculation that produced the amount, its state along the charging lifecycle and the entity that triggered it — a payout, a payin or a transfer between subaccounts. Filter by any of them, or by the date range of the transaction that charged the fee.

See the fees guide for the kinds of fees and their lifecycle.

GET
/v1/core/fees

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

page_number?integer

Number of the page

Default1
Range1 <= value
Example1
page_size?integer

Amount of registers that must be listed by page

Default10
Range10 <= value <= 500
Example10
owner?string

Filter by who charges the fee. Omitted means both owners.

Value in"mono" | "tenant"
Example"mono"
type?string

Filter by kind of fee

Value in"account_to_account_fx" | "account_to_account_fx_spread" | "bank_transfer" | "bank_transfer_gmf" | "payin"
Example"bank_transfer"
state?string

Filter by fee state

Value in"created" | "pending" | "held" | "approved" | "reversed" | "declined"
Example"approved"
account_id?string
Match^[A-Za-z]{2,7}_[\w-]{22}$
Example"lacc_5tgliBmzjZ6mpQPRbQjfKj"
policy_id?string

Filter by the fee policy the fee was priced with

Match^[A-Za-z]{2,7}_[\w-]{22}$
Example"fpol_5tgliBmzjZ6mpQPRbQjfKj"
origin?string

Filter by the kind of entity that triggered the fee

Value in"payin" | "payout" | "subaccount_operation"
Example"payout"
id_in_origin?string
Match^[A-Za-z]{2,7}_[\w-]{22}$
Example"cpout_5tgliBmzjZ6mpQPRbQjfKj"
overridden?boolean

Filter by whether the tenant overrode what the policy priced

Exampletrue
transaction_at?object

Filter by the date range of the transaction that charged the fee.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.sandbox.cuentamono.com/v1/core/fees"
{
  "fees": [
    {
      "account_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj",
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "applied_calculation": {
        "fixed": 900000,
        "percentage": "0"
      },
      "applied_rule": {
        "calculation": {
          "fixed": 900000,
          "percentage": "0"
        },
        "conditions": [
          {
            "left": {
              "property": "method"
            },
            "negated": false,
            "operator": "equal",
            "right": {
              "value": "co_ach"
            }
          }
        ],
        "summary": "Applies to co_ach payouts"
      },
      "id": "fee_5tgliBmzjZ6mpQPRbQjfKj",
      "id_in_origin": "cpout_5tgliBmzjZ6mpQPRbQjfKj",
      "inserted_at": "2022-01-01T01:00:00Z",
      "origin": "payout",
      "overridden": false,
      "overridden_fields": {
        "tx_description": "Custom fee"
      },
      "owner": "mono",
      "policy_id": "fpol_5tgliBmzjZ6mpQPRbQjfKj",
      "processing_subtype": "new_tx",
      "processing_type": "inline",
      "state": "approved",
      "transaction_at": "2022-01-01T01:00:00Z",
      "transaction_description": "Bank transfer fee",
      "type": "bank_transfer",
      "updated_at": "2022-01-01T01:00:00Z"
    }
  ],
  "pagination": {
    "page_number": 1,
    "page_size": 10,
    "total_items": 100,
    "total_pages": 10
  }
}
{
  "code": "401 Unauthorized",
  "errors": [
    {
      "error_code": "missing_authorization_header",
      "message": "`Authorization` header is missing.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Authorization header is missing or invalid."
}
{
  "code": "403 Forbidden",
  "errors": [
    {
      "error_code": "not_authorized",
      "message": "Not authorized to have access to this resource.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Not authorized to have access to this resource"
}
{
  "code": "422 Unprocessable Content",
  "errors": [
    {
      "error_code": "custom",
      "message": "The field contains an invalid value.",
      "path": "#/path/to/field",
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Validation errors"
}