Services
Products this Business can use
GET/services
Scope services.read
The NB02 product catalog, filtered by the Business's contract in force (NB10): each usable product with its parcel limits and promise rule (including the promise if booked now). Products that are switched off or outside the contract are listed in unavailable with a reason.
Request
No parameters.
Response
| Status | Meaning |
|---|---|
200 | Usable and unavailable products |
The body is { "status": "success", "data": … }. Fields of data (ServicesResult):
| Field | Type | Description |
|---|---|---|
marketOptional | MarketCode | Two-letter market (country network) code. Ghana (GH) is live; each market is a separate domestic network. |
servicesRequired | array of Service | |
unavailableRequired | array of ServiceUnavailable | |
contractRequired | ContractSummary or null | |
generatedAtOptional | string (date-time) |
Errors
Errors use the error envelope { "status": "error", "message", "code"?, "details"? }.
| Status | When |
|---|---|
401 | Missing, invalid, expired or revoked API key. The API key is missing, invalid, expired or revoked. |
403 | The key lacks the scope, or the operation needs a LIVE key. The key lacks the scope, or this call needs a LIVE key (LIVE_KEY_REQUIRED), or the Business owner is not verified (SENDER_VERIFICATION_REQUIRED). |
429 | Too many requests. See the RateLimit headers. Too many requests. Wait for Retry-After, then retry with the same idempotency key. |