Platitun · API · Figures and rating · My buyers

My buyers

GET /api/v1/clients

Key scope: stats · read only

How many regular buyers you have and when their subscriptions with you end. Buyers are ANONYMISED: no email, no nickname, no internal id — exactly as in the cabinet.

The API is not a way around what the interface closes: you cannot learn WHO exactly bought, neither here nor anywhere else.

Query filters

Field	Type	What it is
`limit`	`integer`	How many records to return. Default 50, maximum 200.
`skip`	`integer`	How many records to skip. There is no cursor here: the list is grouped by buyer and ordered by purchase count.

Response fields

Field	Type	What it is
`total`	`integer`	How many buyers in total.
`items[].label`	`string`	A position number in the list, not a person identifier.
`items[].purchases`	`integer`	How many purchases they made from you.
`items[].subscriptionEndsAt`	`string\|null`	When their nearest subscription with you ends.
`items[].regular`	`boolean`	Whether they are a regular buyer.

Nearby in this section

GET /api/v1/stats — Sales figures
GET /api/v1/rating — My rating and its log