iotoms Docs

List commission settlement runs

GET
/api/v1/commission/settlements

Returns commission settlement runs, newest period first. Paginated with 0-based page and size (default 20).

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Query Parameters

page?integer

Page number, starting at 0. See Paging.

Formatint32
Default0
size?integer

Number of records per page.

Formatint32
Default20

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the request: SUCCESS when it worked; errors return an error status with the reason in message.

message*string

Short human-readable message describing the outcome.

data?

One page of settlement run summaries, newest period first.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/commission/settlements' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "content": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "periodFrom": "2019-08-24",        "periodTo": "2019-08-24",        "status": "DRAFT",        "totalCommission": 0,        "peopleCount": 0,        "createdAt": "2019-08-24T14:15:22Z",        "approvedAt": "2019-08-24T14:15:22Z"      }    ],    "page": 0,    "size": 0,    "totalElements": 0,    "totalPages": 0  }}