Invoices

Fetch an invoice

GET/api/v1/invoices/{invoiceID}

One invoice with its items

AuthorizationBearer sk_test_… or sk_live_…

Path parameters#

invoiceIDuuidRequired

Responses#

200OK
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.
404Nothing was found for this business and mode.

curl "https://api.vervapay.com/api/v1/invoices/6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11" \
  -H "Authorization: Bearer $FASTPAY_SECRET_KEY"

200OK

{
  "data": {
    "created_at": "2026-10-28T09:00:00Z",
    "currency": "NGN",
    "customer_email": "ada@example.com",
    "discount_minor": 0,
    "id": "6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11",
    "items": [
      {
        "description": "Order 1001",
        "quantity": 3,
        "unit_price_minor": 500000
      }
    ],
    "kind": "simple",
    "mode": "test",
    "number": "INV-0001",
    "state": "draft",
    "status": "draft",
    "subtotal_minor": 1500000,
    "tax_bps": 0,
    "tax_minor": 0,
    "total_minor": 1500000,
    "url": "https://fastpay.ng/i/…",
    "customer_id": "0b8c3d3e-6c1a-4b36-8d5e-2a9d1f4c7e02"
  }
}