Getting a list of invoices

The method allows you to get a list of invoices

Getting a list of invoices

POSThttps://ocp.onchainpay.io/api-gateway/get-invoices

Header parameters

Body

application/json

statusarray of enum

Array for filtering orders by status

limitinteger

Number of elements per page

offsetinteger

Number of items to skip

Response

200

Body

application/json

success*boolean

Request success indicator

response*GetInvoicesResponse (object)

The body of the response to the request for a list of invoices

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/get-invoices', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "success": false,
  "response": {
    "invoices": [
      {
        "id": "7ddf4231-4fba-40c3-9be4-b0b3ead76cb8",
        "advancedBalanceId": "dcde70b7-e684-434f-9a7c-377d2010e66e",
        "externalId": "merchantExternalId123",
        "orderId": "1f627ca9-009d-47e9-9873-40920fe8c9cf",
        "orderLink": "https://payment.domain/1f627ca9-009d-47e9-9873-40920fe8c9cf",
        "invoiceLink": "https://invoices.domain/7ddf4231-4fba-40c3-9be4-b0b3ead76cb8",
        "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": false,
        "additionalFees": [
          "SEPA_WITHDRAWAL"
        ],
        "insurancePercent": "1",
        "slippagePercent": "2",
        "paymentTolerancePercent": "1.5",
        "webhookURL": "https://merchant.domain/webhooks/invoice",
        "returnUrl": "https://merchant.domain/",
        "expiresAt": "2024-12-11T10:54:33.330Z",
        "createdAt": "2024-12-11T10:54:03.330Z",
        "currencies": [
          {
            "currency": "USDT",
            "networks": [
              {
                "name": "ethereum",
                "amount": "25"
              }
            ]
          }
        ]
      }
    ],
    "total": "900"
  }
}