v1
latestOpenAPI 3.0.12026-07-243686491.1 MBSplit Billing
Retrieve a list of split billing settlements
Required scope: split-billing:read
get/api/v1/split-billing/settlements
Query parameters
pageinteger
page number to retrieve (starts with 0)
perPageinteger
number of items per page (between 1 and 100, default 10)
teamIdinteger nullable
Filter settlements by the team they belong to.
Example:42
status'pending' | 'completed' | 'failed'
createdAtFromstring date-time nullable
Return settlements created on or after this timestamp (ISO 8601, e.g. 2026-01-01T00:00:00Z).
Example:2026-01-01T00:00:00Z
createdAtTostring date-time nullable
Return settlements created on or before this timestamp (ISO 8601, e.g. 2026-03-31T23:59:59Z).
Example:2026-03-31T23:59:59Z
Response
List of split billing settlements that match the criteria
Example response
{
"data": [
{
"id": 42,
"teamId": 1024,
"userId": 5050,
"amount": {
"amount": 12312,
"currency": {
"id": 1,
"master": true,
"identifier": "DKK",
"name": "Danish krone",
"decimals": 2
},
"locale": "en"
},
"total": {
"amount": 12312,
"currency": {
"id": 1,
"master": true,
"identifier": "DKK",
"name": "Danish krone",
"decimals": 2
},
"locale": "en"
},
"attempts": 1,
"lastAttemptAt": "2026-05-10T08:30:00Z",
"period": "April 2026",
"firstItemAt": "2026-04-02T08:00:00Z",
"lastItemAt": "2026-04-29T19:30:00Z",
"sessionCount": 7,
"createdAt": "2026-05-01T00:00:00Z"
}
]
}