Orders

Get an order

GEThttps://stagingapi.getelectric.ng/api/v2/reseller/orders/{reference}

One order, by the reference you gave it. This is how you poll an order that was still processing, and how you recover after a timeout when you are not sure whether your order was created.

Shares the budget your orders do not reserve. Works with a live or test key.

Request
curl 'https://stagingapi.getelectric.ng/api/v2/reseller/orders/reference' \
  -H 'Authorization: Bearer <your-test-key>'
Response
// The order.

Authorization

Authorizationstringheaderrequired

Your reseller API key, as Bearer <key>.

Path parameters

referencestringpathrequired

The reference you sent when placing the order.

At most 120 characters

Response 200

The order.

successbooleanrequired
statusstringrequired
codeintegerrequired
messagestringrequired
dataobjectrequired

Every field is always present. An empty string or a zero id comes back as null rather than being left out.

Show child attributes
referencestringrequired

Your reference, as you sent it.

At most 120 characters

modestringrequired

One of live, test

servicestringrequired

One of electricity, airtime, data, cable_tv

statestringrequired

delivered, failed and refunded are terminal. accepted and processing are not: keep polling, or wait for the webhook.

One of accepted, processing, delivered, failed, refunded

settledbooleanrequired

True once the state is terminal and the money has stopped moving.

meter_numberstringnullablerequired
disco_codestringnullablerequired
targetstringnullablerequired

The phone or smartcard number, for anything that is not electricity.

At most 64 characters

provider_idintegernullablerequired
plan_idintegernullablerequired
amountnumberrequired

Naira.

messagestringrequired

Plain words about where the order stands. For people, not for branching on.

transactionstringnullablerequired

Our transaction reference, once there is one.

tokenstringnullablerequired

The electricity token, once delivered. Never set for anything but electricity.

token_unitsnumbernullablerequired

Units the token carries, in kWh.

placed_atstringrequired

Always UTC, written 2026-11-18T09:14:22Z with no offset. Note that the webhook uses a different format, so parse with a real RFC 3339 parser rather than a fixed pattern.

UTC with no offset, written 2026-11-18T09:14:22Z.

updated_atstringrequired

UTC with no offset, written 2026-11-18T09:14:22Z.

phone_numberstringnullablerequired

Whatever you sent, echoed back. We do not validate it.

Other responses

401
No key, a malformed Authorization header, or a key that no longer exists.
403
The key is real but may not do this. Three separate causes, and only the message tells them apart: the token cannot use the reseller API at all, the calling address is not on your allowlist, or the key carries both test and live access and must be reissued for one mode.
404
No order of yours carries that reference in this mode. After a timeout this means nothing was created and the reference is still free to use.
429
You have too many requests open at once. This is a concurrency cap, not a rate limit: wait for your open requests to finish rather than backing off a fixed time. Retry-After is 1.
503
Our side could not serve this. Safe to retry.