List a person's commission statements
GET
Returns every settlement line for one person (userRef, their username) across all runs, so a salesperson's commission history can be shown in one place. Lines are not returned in date order; sort by the run on your side if you need a timeline. uncollectedCredit is always 0 here.
BearerAuthheader
AuthorizationBearer <JWT>userRef*stringUsername of the salesperson whose commission lines to return.
X-TenantID*stringYour merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.
OK
*/*- response
status*stringOutcome of the request: SUCCESS when it worked; errors return an error status with the reason in message.
message*stringShort human-readable message describing the outcome.
data?array<>|The person's settlement lines across all runs (not in date order).
Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/commission/settlements/statements/string' \ -H 'X-TenantID: your-tenant-code'Example Response
{ "status": "string", "message": "string", "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "userRef": "string", "planId": "b3f60ba2-c1fd-4b3a-a23d-8e876e0ef75d", "planName": "string", "rateStructure": "FLAT", "rateBp": 0, "collectedBase": 0, "returnsBase": 0, "netBase": 0, "commissionAmount": 0, "paidAmount": 0, "status": "DRAFT", "uncollectedCredit": 0, "sources": [ { "sourceType": "SALE_COLLECTION", "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052", "documentDate": "2019-08-24", "documentRef": "string", "grossAmount": 0, "baseAmount": 0 } ] } ]}