Settlements

GET /v1/settlements

Settlement history

settlements:read

Returns completed payouts to your organisation, newest first. collections covers recovered debt; invoicing covers customer payments collected through invoice service. Amounts are integer øre. This is history only: it does not predict the next payout date, and line-level specifications remain available in the portal.

Parameter	In	Type	Required	Description
limit	query	integer	No	Page size, 1-200 (default 50)
cursor	query	string	No	Opaque cursor from meta.nextCursor

Request exampleNo request body

curl

curl https://api.rieckflow.com/v1/settlements \
  -H "Authorization: Bearer $RIECK_API_KEY"

TypeScript

const svar = await rieck.request("GET", "/v1/settlements");

Response

{
  "data": [
    {
      "id": "9b2f1c1e-6b87-4d9b-91a0-47c8d72b8440",
      "type": "invoicing",
      "settledAt": "2026-08-04T06:00:00Z",
      "payoutOere": 151250,
      "feeOere": 5000,
      "vatOere": null,
      "vatOffsetOere": 0,
      "lineCount": 4
    }
  ],
  "meta": {
    "nextCursor": null
  }
}

200 Paginated collection and invoicing payouts, newest first.application/json

Response fields 9

Field	Type	Description
data[].id	uuid	Stable settlement id.
data[].type	collections | invoicing	Origin of the payout.
data[].payoutOere	integer	Net amount paid out to you.
data[].feeOere	integer	Rieck fee deducted from the payout.
data[].vatOere	integer | null	VAT on the fee for collection settlements; null for invoicing.
data[].vatOffsetOere	integer	VAT offset against the collected amount.
data[].lineCount	integer	Number of lines included in the settlement.
data[].settledAt	date-time	UTC settlement timestamp.
meta.nextCursor	`string	null`

Possible errors 5

HTTP	Code	Meaning
400	invalid_cursor	The cursor is malformed, expired or belongs to another list shape.
401	invalid_api_key	The API key is missing, invalid, expired or revoked.
403	api_not_included	The organisation’s plan does not include API access.
403	insufficient_scope	The key does not have the required scope.
429	rate_limited	The organisation’s rate budget is exhausted.