Platitun · API · Catalogue and requests · Who am I

Who am I

GET /api/v1/me

Key scope: catalog · read only

A key check and the seller state in one request: nickname, status, whether listings reach the storefront and what is missing for that. Available to any key with at least one scope — the only endpoint without a scope of its own.

This response is the fastest way to see why your stock is not on the storefront: look at blockers instead of guessing.

Response fields

Field	Type	What it is
`sellerId`	`string`	The seller’s internal id.
`nickname`	`string\|null`	The nickname the buyer sees.
`isTest`	`boolean`	Test role: deals are not real and listings are born as test ones.
`sellerType`	`string\|null`	ooo, ip or self_employed.
`sellerStatus`	`string\|null`	pending, active, suspended or blocked.
`listable`	`boolean`	Whether listings reach the storefront right now.
`blockers`	`array`	What is missing before the storefront. An empty list means everything is fine. Computed by the same core as the storefront.
`scopes`	`array`	What THIS key can do.

Example

GET /api/v1/me
Authorization: Bearer ptk_…

→ 200 {
  "nickname": "seller_A",
  "isTest": true,
  "listable": true,
  "blockers": [],
  "scopes": ["catalog","listings","stock","stats"]
}

Nearby in this section

GET /api/v1/catalog/services — Search the catalogue
GET /api/v1/catalog/services/{slug} — Everything about a position
GET /api/v1/catalog/usual-price — The usual price for a position
GET /api/v1/catalog/demand — Demand: what buyers are waiting for
GET /api/v1/catalog/requests — My catalogue requests
POST /api/v1/catalog/requests — Request a new catalogue position