Plateshka
APIСчета

Лента счетов

Курсорная выдача от новых к старым. Есть ли ещё страница — в `hasMore`, курсор следующей — в `nextCursor`.

GET/v1/invoices

Курсорная выдача от новых к старым. Есть ли ещё страница — в hasMore, курсор следующей — в nextCursor.

АвторизацияBearer <token>

Заголовок Authorization: Bearer <ключ>, например Authorization: Bearer plt_ExampleKeyDoNotUseExampleKeyDoNotUse01. Название схемы сравнивается без учёта регистра. Ключ начинается с plt_; храним мы только его SHA-256, поэтому потерянный ключ не восстанавливается — он перевыпускается.

In: header

Параметры запроса

status?string

Фильтр по статусам, через запятую. Перечень — в разделе «Статусы счёта».

createdAfter?string

Нижняя граница по времени создания, включительно.

Formatdate-time
createdBefore?string

Верхняя граница по времени создания, включительно.

Formatdate-time
limit?integer

Размер страницы.

Range1 <= value <= 100
cursor?string

Курсор из nextCursor предыдущей страницы. Непрозрачен: разбирать нельзя.

Length1 <= length

Тело ответа

application/json

application/json

curl -X GET "https://example.com/v1/invoices?status=success%2Crefunded&createdAfter=2026-08-01T00%3A00%3A00Z&createdBefore=2026-08-19T00%3A00%3A00Z&limit=50"
{  "data": [    {      "id": "9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50",      "status": "success",      "amount": {        "amount": "149900",        "currency": "RUB"      },      "description": "Подписка «Про», 1 месяц",      "comment": null,      "customer": {        "email": "[email protected]",        "phone": null,        "externalId": "user-7781"      },      "metadata": {        "orderId": "4815162342"      },      "paymentUrl": "https://pay.example.com/i/9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50",      "returnUrl": "https://shop.example.com/orders/4815162342",      "method": "sbp",      "pinnedMethod": "sbp",      "createdAt": "2026-08-19T10:15:30Z",      "expiresAt": "2026-08-20T10:15:30Z",      "paidAt": "2026-08-19T10:19:04Z"    },    {      "id": "9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50",      "status": "created",      "amount": {        "amount": "149900",        "currency": "RUB"      },      "description": "Подписка «Про», 1 месяц",      "comment": null,      "customer": {        "email": "[email protected]",        "phone": null,        "externalId": "user-7781"      },      "metadata": {        "orderId": "4815162342"      },      "paymentUrl": "https://pay.example.com/i/9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50",      "returnUrl": "https://shop.example.com/orders/4815162342",      "method": null,      "pinnedMethod": "sbp",      "createdAt": "2026-08-19T10:15:30Z",      "expiresAt": "2026-08-20T10:15:30Z",      "paidAt": null    }  ],  "hasMore": true,  "nextCursor": "MjAyNi0wOC0xOVQxMDoxNTozMFo6OWYxZDRjMDI"}