Look up data plans for a provider 🔒

curl --request GET \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/vas/internet/data/lookup \
  --header 'X-Numero-Api-Key: <api-key>' \
  --header 'X-Numero-Signature: <api-key>'

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "N20260616120000",
  "data": {
    "plans": [
      {
        "code": "MTN_1GB_30D",
        "name": "1GB - 30 days",
        "price": "500",
        "amount": "500",
        "validity": "30 days"
      },
      {
        "code": "MTN_2GB_30D",
        "name": "2GB - 30 days",
        "price": "1000",
        "amount": "1000",
        "validity": "30 days"
      }
    ]
  },
  "error": null
}

GET

business

vas

internet

data

lookup

Look up data plans for a provider 🔒

curl --request GET \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/vas/internet/data/lookup \
  --header 'X-Numero-Api-Key: <api-key>' \
  --header 'X-Numero-Signature: <api-key>'

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "N20260616120000",
  "data": {
    "plans": [
      {
        "code": "MTN_1GB_30D",
        "name": "1GB - 30 days",
        "price": "500",
        "amount": "500",
        "validity": "30 days"
      },
      {
        "code": "MTN_2GB_30D",
        "name": "2GB - 30 days",
        "price": "1000",
        "amount": "1000",
        "validity": "30 days"
      }
    ]
  },
  "error": null
}

Authorizations

X-Numero-Api-Key

string

header

required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

X-Numero-Signature

string

header

required

Base64(HMAC-SHA256(secretApiKey, input)) over the raw request body (POST) or canonicalized query string (signed GET). Also send X-Numero-Signature-Version: v2. Required on money-movement / state-changing endpoints (marked 🔒).

Query Parameters

provider

string

required

Response

Successful response

Canonical response envelope for the public surface. data on success, error on failure.

data

any

required

Endpoint payload on success (object or array); null on failure.

error

object

required

Show child attributes