Getting a list of invoices

The method allows you to get a list of invoices

Getting a list of invoices

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

Request body for getting a list of invoices

limitintegerOptional

Number of elements per page

offsetintegerOptional

Number of items to skip

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/get-invoices HTTP/1.1
Host: app.apollopayment.io
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "status": [
    "INIT"
  ],
  "limit": 1,
  "offset": 1
}

200Success

{
  "success": true,
  "response": {
    "invoices": [
      {
        "id": "d6201e89-74ea-478d-b476-cb7e60522d91",
        "advancedBalanceId": "d464decd-5cc8-42de-8f57-c55a862d0e87",
        "externalId": "merchantExternalId123",
        "externalUserId": "10099",
        "payerEmail": "[e-mail]",
        "orderId": "a9236d98-9d22-4495-b387-cfa72b45b0d8",
        "orderLink": "https://payment.domain/a9236d98-9d22-4495-b387-cfa72b45b0d8",
        "invoiceLink": "https://invoices.domain/d6201e89-74ea-478d-b476-cb7e60522d91",
        "status": "INIT",
        "order": "Order #123456",
        "description": "Payment by order #123456",
        "currency": "USD",
        "amount": "20",
        "receivedNetwork": "USDT",
        "receivedCurrency": "USDT",
        "receivedAmount": "100.32",
        "receivedAmountInInvoiceCurrency": "100.94",
        "rate": "100.32",
        "includeFee": true,
        "additionalFees": [
          "SEPA_WITHDRAWAL"
        ],
        "insurancePercent": "1",
        "slippagePercent": "2",
        "paymentTolerancePercent": "1.5",
        "webhookURL": "https://merchant.domain/webhooks/invoice",
        "returnUrl": "https://merchant.domain/",
        "expiresAt": "2025-05-14T13:51:01.650Z",
        "createdAt": "2025-05-14T13:50:31.650Z",
        "currencies": [
          {
            "currency": "USDT",
            "networks": [
              {
                "name": "ethereum",
                "amount": "25"
              }
            ]
          }
        ]
      }
    ],
    "total": "900"
  }
}