Список счетов

Получение списка всех счетов с пагинацией и фильтрацией

GET /api/v1/invoices

Список счетов

cURL

curl --request GET \
  --url https://loveandpay.io/api/v1/invoices \
  --header 'x-api-key: <x-api-key>'

200

{
  "invoices": [
    {}
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123
  }
}

Получение списка счетов

Возвращает список всех счетов с поддержкой пагинации и фильтрации.

Аутентификация

x-api-key · string · required

Ваш API ключ

Query параметры

page · number · default: "1"

Номер страницы

limit · number · default: "20"

Количество записей на странице (максимум 100)

status · string

Фильтр по статусу: pending, paid, expired, cancelled

from · string

Начальная дата в формате ISO 8601

to · string

Конечная дата в формате ISO 8601

currency · string

Фильтр по валюте: USD, EUR, RUB, KZT

Пример запроса

cURL

curl -X GET "https://loveandpay.io/api/v1/invoices?status=paid&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

Пример ответа

invoices · array

Массив счетов

pagination · object

Информация о пагинации

Show Поля pagination

page · number

Текущая страница

limit · number

Записей на странице

total · number

Общее количество записей

totalPages · number

Общее количество страниц

Успешный ответ (200)

{
  "invoices": [
    {
      "id": "inv_abc123def456",
      "amount": 100.00,
      "currency": "USD",
      "description": "Оплата заказа #12345",
      "status": "paid",
      "paymentUrl": "https://pay.loveandpay.io/inv_abc123def456",
      "metadata": {
        "orderId": "12345"
      },
      "createdAt": "2024-01-15T10:30:00Z",
      "paidAt": "2024-01-15T10:35:00Z"
    },
    {
      "id": "inv_xyz789ghi012",
      "amount": 50.00,
      "currency": "USD",
      "description": "Подписка Pro",
      "status": "paid",
      "paymentUrl": "https://pay.loveandpay.io/inv_xyz789ghi012",
      "metadata": {
        "subscriptionId": "sub_001"
      },
      "createdAt": "2024-01-14T15:00:00Z",
      "paidAt": "2024-01-14T15:05:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 156,
    "totalPages": 16
  }
}

Ошибки

Код	Описание
400	Неверные параметры запроса
401	Неверный API ключ