Orders

List orders

GET/api/v1/orders

Orders from your stores and payment links, newest first.

AuthorizationBearer sk_test_… or sk_live_…

Query parameters#

sourcestringOptional
One of storefront, payment_link.
statusstringOptional
One of pending, paid, expired, cancelled.
payment_link_iduuidOptional
storefront_iduuidOptional
referencestringOptional
Part of an order number. Up to 200 characters.
created_fromtimestampOptional
created_totimestampOptional
Exclusive.
limitintegerOptional
From 1 to 200.
offsetintegerOptional
At least 0.

Responses#

200Orders
401The secret key is missing, invalid or revoked.
403The key is not allowed to do this, or the request came from an address that is not on its allowlist.
422A field is missing or not valid.

curl "https://api.vervapay.com/api/v1/orders?limit=10" \
  -H "Authorization: Bearer $FASTPAY_SECRET_KEY"

200Orders

{
  "data": {
    "items": [
      {
        "amount_minor": 500000,
        "created_at": "2026-10-28T09:00:00Z",
        "currency": "NGN",
        "customer": {
          "email": "ada@example.com",
          "first_name": "Ada",
          "last_name": "Obi",
          "phone": "+2348012345678"
        },
        "delivery_fee_minor": 1,
        "discount_minor": 0,
        "fulfillment_status": "unfulfilled",
        "id": "6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11",
        "items": [
          {
            "line_total_minor": 1500000,
            "name": "string",
            "quantity": 3,
            "unit_price_minor": 500000
          }
        ],
        "mode": "test",
        "reference": "order-1001",
        "source": "storefront",
        "status": "pending",
        "subtotal_minor": 1500000
      }
    ],
    "to_fulfil": 1,
    "total": 1,
    "total_capped": false
  }
}