Getting a list of orders

The method allows you to get a list of orders

Getting a list of orders

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 orders

limitintegerOptional

Number of elements per page

offsetintegerOptional

Number of items to skip

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/orders HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 43

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

200Success

{
  "success": true,
  "response": {
    "orders": [
      {
        "status": "pending",
        "link": "https://payment.domain/6cbc8dbc-1813-4b9b-a888-d5a48a8b4677",
        "amount": "123.12",
        "paymentTolerancePercent": "1.5",
        "currency": "USDT",
        "network": "ethereum",
        "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
        "addressId": "7a4043e6-793e-4677-8c5a-1b293fe13020",
        "tag": null,
        "orderId": "6cbc8dbc-1813-4b9b-a888-d5a48a8b4677",
        "clientOrderId": "Order #123456",
        "externalUserId": "10099",
        "payerEmail": "[e-mail]",
        "description": "Payment by order #123456",
        "successWebhook": "https://merchant.domain/webhooks/success",
        "errorWebhook": "https://merchant.domain/webhooks/fail",
        "returnUrl": "https://merchant.domain/",
        "expiresAt": "2025-06-04T10:06:10.118Z",
        "createdAt": "2025-06-04T09:36:10.118Z"
      }
    ],
    "total": "1000"
  }
}