Catalog
List Data Packages
Return active data packages, optionally filtered by operator or product.
Endpoint
GET /api/v1/data-packages
Query parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
operatorId | operators id | No | Restrict packages to one operator |
productId | products id | No | Restrict packages to one product |
The API resolves pricing from the authenticated user role, so package prices can differ by the API key owner.
Response
Returns an array of package objects with pricing and operator details:
{
"success": true,
"data": [
{
"_id": "kn76jer7k08d2nrg8jphjvy07183gvs4",
"dataAmount": "1GB",
"label": "1GB",
"operatorId": "kd7ff6sssan1v3d00dbbttwaa57yp27d",
"operatorName": "MTN",
"price": 4.5,
"productId": "m176bnddfzcp42fyhkaekker5s83gehh",
"productName": "MTNUP2U - Data Bundle",
"sellPrice": 5,
"validity": "90"
},
{
"_id": "kn7fp19rtebh800zc4pekq9gf183ggr4",
"dataAmount": "2GB",
"label": "2GB",
"operatorId": "kd7ff6sssan1v3d00dbbttwaa57yp27d",
"operatorName": "MTN",
"price": 9,
"productId": "m176bnddfzcp42fyhkaekker5s83gehh",
"productName": "MTNUP2U - Data Bundle",
"sellPrice": 9.5,
"validity": "90"
},
{
"_id": "kn7e5k5jk2065077gr70vh6zrd83hev6",
"dataAmount": "3GB",
"label": "3GB",
"operatorId": "kd7ff6sssan1v3d00dbbttwaa57yp27d",
"operatorName": "MTN",
"price": 13.5,
"productId": "m176bnddfzcp42fyhkaekker5s83gehh",
"productName": "MTNUP2U - Data Bundle",
"sellPrice": 14.3,
"validity": "90"
},
{
"_id": "kn786rjv9eqj1wpab0pv0tzhdn83h1s6",
"dataAmount": "4GB",
"label": "4GB",
"operatorId": "kd7ff6sssan1v3d00dbbttwaa57yp27d",
"operatorName": "MTN",
"price": 18,
"productId": "m176bnddfzcp42fyhkaekker5s83gehh",
"productName": "MTNUP2U - Data Bundle",
"sellPrice": 19,
"validity": "90"
},
{
"_id": "kn73tcktqjscptz1w5csgwr4k583hgtf",
"dataAmount": "5GB",
"label": "5GB",
"operatorId": "kd7ff6sssan1v3d00dbbttwaa57yp27d",
"operatorName": "MTN",
"price": 22,
"productId": "m176bnddfzcp42fyhkaekker5s83gehh",
"productName": "MTNUP2U - Data Bundle",
"sellPrice": 22.5,
"validity": "90"
}
]
}Response fields
| Field | Type | Notes |
|---|---|---|
_id | string | Package identifier |
label | string | Human-readable package description (e.g. "1GB", "5GB") |
dataAmount | string | Bundle size (e.g. "1GB", "5GB") |
validity | string | Validity period in days (e.g. "90") |
price | number | Effective price for authenticated role |
sellPrice | number | Customer-facing sell price |
operatorId | string | Parent operator ID |
operatorName | string | Operator name (e.g. "MTN", "AT", "Telecel") |
productId | string | Parent product ID |
productName | string | Product name (e.g. "MTNUP2U - Data Bundle") |
Sample request
curl -X GET "https://api.netconnectgh.online/api/v1/data-packages?operatorId=k57exampleoperator" \
-H "X-API-KEY: netconnect_live_your_secret_here" \
-H "Content-Type: application/json"