List late-fee policies

GET/v1/late-fee-policies

Coming the week of 11 January 2027

This endpoint ships in the week of 11 January 2027. The shape shown here can still change before release.

Returns the late-fee policies of your businesses, including client overrides.

A business has at most one policy, plus at most one override per client (client_id set). For a late invoice the client's policy is used when there is one, otherwise the business policy. Late fees are off by default. See Late fees.

Permission: documents.view
Type: Read-only. Changes nothing.
Auth: API key, MCP token or signed-in session
Capability: list_late_fee_policies
CLI: freeinvoiceautomation late-fee list
Available: From the week of 11 January 2027

list_late_fee_policies

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/late-fee-policies \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f2c5-1d2e-7f3a-8b4c-5d6e7f8a9b0c",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "client_id": null,
      "type": "percent",
      "amount_minor": null,
      "currency": null,
      "percent": "1.5000",
      "statutory_preset_key": null,
      "grace_days": 7,
      "repeat": "every_n_days",
      "repeat_every_days": 30,
      "max_total_minor": "15000",
      "enabled": true,
      "created_at": "2027-01-12T09:30:00Z",
      "updated_at": "2027-01-12T09:30:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorizationstringrequired

Bearer <api-key>. An API key from Settings > API keys, or an MCP token. See Authentication.

Query Parameters

business_idstring<uuid>

Only policies of this business.

client_idstring<uuid>

Only the override for this client.

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The policies on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Errors

business_out_of_scope

Plus the common errors every call can return. See Errors.

Suggest edits Raise issue

Set a promise-to-pay datePrevious Create or update a late-fee policyNext

list_late_fee_policies

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/late-fee-policies \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f2c5-1d2e-7f3a-8b4c-5d6e7f8a9b0c",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "client_id": null,
      "type": "percent",
      "amount_minor": null,
      "currency": null,
      "percent": "1.5000",
      "statutory_preset_key": null,
      "grace_days": 7,
      "repeat": "every_n_days",
      "repeat_every_days": 30,
      "max_total_minor": "15000",
      "enabled": true,
      "created_at": "2027-01-12T09:30:00Z",
      "updated_at": "2027-01-12T09:30:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}