Platitun · API · Documents and payout details · My seller admission

My seller admission

GET /api/v1/papers

Key scope: documents · read only

What is filled in and what stops you from reaching the storefront: nickname, offer, status with the tax number, the registry name check, payout details. The account number is returned only as its last four digits.

A test account needs no paperwork: its admission counts as complete without documents — that is exactly what the flag is for.

Response fields

Field	Type	What it is
`nickname`	`string\|null`	The nickname the buyer sees.
`sellerType`	`string\|null`	ooo, ip or self_employed.
`inn`	`string\|null`	The tax number as recorded.
`offerAcceptedAt`	`string\|null`	When the seller offer was accepted.
`registry`	`object`	The registry check: the name found, when it was checked, whether it is confirmed, and a reason code if it did not match.
`payout`	`object`	Payout details: method, the last four digits of the account, the bank code, the recipient, and whether everything is filled.
`listable`	`boolean`	Whether listings reach the storefront right now.

Refusal reasons

A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.

Code	What happened and what to do
`not_found`	The record does not exist or is not yours. The ownership condition is in the database query itself, so someone else’s record looks like a missing one.

Nearby in this section

PUT /api/v1/papers/nickname — The seller nickname
POST /api/v1/papers/offer — Accept the seller offer
PUT /api/v1/papers/status — Status and tax number
POST /api/v1/papers/registry-confirm — Confirm the name
PUT /api/v1/papers/payout — Payout details