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

statusstring · enum[]optional

Array for filtering orders by status

Example: pending

limitintegeroptional

Number of elements per page

offsetintegeroptional

Number of items to skip

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/orders' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": [
      "pending"
    ],
    "limit": 1,
    "offset": 1
  }'

200

200

{
  "success": true,
  "response": {
    "orders": [
      {
        "status": "pending",
        "link": "https://payment.domain/a7ff7a80-dd8e-40e7-a262-4599b007211b",
        "amount": "123.12",
        "paymentTolerancePercent": "1.5",
        "advancedBalanceId": "1503cf18-597f-447f-b172-112dfe377e1b",
        "currency": "USDT",
        "network": "ethereum",
        "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
        "addressId": "42a54680-0511-4aa0-ba46-5cf1b7de1fd3",
        "tag": null,
        "orderId": "a7ff7a80-dd8e-40e7-a262-4599b007211b",
        "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": "2024-12-26T08:51:33.210Z",
        "createdAt": "2024-12-26T08:21:33.210Z"
      }
    ],
    "total": "1000"
  }
}