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
AuthorizationstringheaderrequiredYour reseller API key, as Bearer <key>.
Response 200
The services on sale.
successbooleanrequiredstatusstringrequiredOne of success, failed
codeintegerrequiredThe 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.
messagestringrequireddataobjectrequiredShow child attributes
servicesarray of objectrequiredShow child attributes
codestringrequiredWhat you send as service on an order.
namestringrequiredpricingstringrequiredOPEN takes an amount. FIXED takes a plan_id.
One of OPEN, FIXED
needs_lookupbooleanrequiredTrue when you must call verifyTarget before ordering.
target_labelstringrequiredWhat to call the target when you ask a customer for it.
iconstringsort_orderintegerrequiredOther 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.