Mono Colombia
GuíasReferencia de API

Lists the fee policies that apply to an account

Shows, for one of your subaccounts, every fee policy that could price a fee on it and which one actually does. Use it to answer "how much will this account be charged, and why?", or to check the effect of a policy you just created or skipped.

How the response is built

The policies come grouped by fee type. Within each group they go from the most to the least specific target — account, account_holder, program, tenant — and exactly one has applied: true: the most specific one that is not skipped or paused. Skipped (paused) policies are listed with applied: false, so it is visible why a policy is not applying. Only the policies with a strategy in the account's currency bear on the account, and only the fee types with at least one policy are present.

Scope

Only subaccounts have policies applied on them. Any other kind of account, or an account that isn't yours, is reported as account_not_found. Narrow the response to a single fee type with fee_type.

See who a policy applies to in the fee policies guide.

GET
/v1/ledger/accounts/{account_id}/fees/policies

Autorización

AutorizaciónBearer <token>

En: header

Parámetros de ruta

account_idstring

Account ID (Base 62 format)

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

Parámetros de consulta

fee_type?string

Narrows the response to the policies of a single fee type

Value in"account_to_account_fx" | "account_to_account_fx_spread" | "bank_transfer" | "bank_transfer_gmf" | "payin"
Example"bank_transfer"

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

curl -X GET "https://api.sandbox.cuentamono.com/v1/ledger/accounts/lacc_5tgliBmzjZ6mpQPRbQjfKj/fees/policies"
{
  "policies": {
    "bank_transfer": [
      {
        "applied": true,
        "fee_type": "bank_transfer",
        "id": "fpol_5tgliBmzjZ6mpQPRbQjfKj",
        "inserted_at": "2026-01-01T01:00:00Z",
        "processing_subtype": "add_posting",
        "processing_type": "inline",
        "skip": false,
        "strategies": {
          "COP": {
            "default_calculation": {
              "fixed": 900000,
              "percentage": "0"
            },
            "rules": []
          }
        },
        "summary": "Account bank transfer fee",
        "target_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj",
        "target_type": "account",
        "transaction_description": "Bank transfer fee",
        "updated_at": "2026-01-01T01:00:00Z"
      },
      {
        "applied": false,
        "fee_type": "bank_transfer",
        "id": "fpol_3rbnHF9AtEBSyyfqZAmnii",
        "inserted_at": "2026-01-01T01:00:00Z",
        "processing_subtype": "add_posting",
        "processing_type": "inline",
        "skip": false,
        "strategies": {
          "COP": {
            "default_calculation": {
              "fixed": 500000,
              "percentage": "0"
            },
            "rules": []
          }
        },
        "summary": "Tenant bank transfer fee",
        "target_id": "cli_5tgliBmzjZ6mpQPRbQjfKj",
        "target_type": "tenant",
        "transaction_description": null,
        "updated_at": "2026-01-01T01:00:00Z"
      }
    ]
  }
}
{
  "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": "404 Not Found",
  "errors": [
    {
      "error_code": "account_not_found",
      "message": "The account ID doesn't exist.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Resource not defined"
}