Catalogue

List services

GEThttps://stagingapi.getelectric.ng/api/v2/reseller/catalogue/services

What you can sell. pricing tells you which shape an order takes: OPEN means the customer names an amount, FIXED means they pick a plan.

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

Request
curl 'https://stagingapi.getelectric.ng/api/v2/reseller/catalogue/services' \
  -H 'Authorization: Bearer <your-test-key>'
Response
// The services on sale.

Authorization

Authorizationstringheaderrequired

Your reseller API key, as Bearer <key>.

Response 200

The services on sale.

successbooleanrequired
statusstringrequired

One of success, failed

codeintegerrequired

The HTTP status, repeated in the body. It is not an error code: this API has none, so the message text is the only thing distinguishing one refusal from another, and message text is not a stable contract.

messagestringrequired
dataobjectrequired
Show child attributes
servicesarray of objectrequired
Show child attributes
codestringrequired

What you send as service on an order.

namestringrequired
pricingstringrequired

OPEN takes an amount. FIXED takes a plan_id.

One of OPEN, FIXED

needs_lookupbooleanrequired

True when you must call verifyTarget before ordering.

target_labelstringrequired

What to call the target when you ask a customer for it.

iconstring
sort_orderintegerrequired

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.
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
We could not load the catalogue. Safe to retry.