---
title: "Vend data bundles via parent account"
method: POST
path: "/v1/bill/data"
tags: ["Airtime and Data Vending"]
---

# Vend data bundles via parent account

`POST /v1/bill/data`

You can use this endpoint to vend data via parent account

## Headers

- `accountId` string, uuid, required

## Request body

- DataVendingRequest
  - `amount` number, double, required — The data amount to be vended
  - `phoneNumber` string, required — Recipient phone number
  - `network` 'GLO' | 'MTN' | '9MOBILE' | 'AIRTEL', required — Recipient network (telco). It can also come as lowercased values e.g. glo, mtn etc.
  - `merchantTxRef` string, required — Merchant Transaction Identifier reference (Unique to merchant)
  - `senderName` string — A name to describe the sender of the data

## Response `200`

OK - your request was successful.

- object
  - `code` string, required — Response Code
  - `description` string, required — Response description
  - `data` DataVendingResponse, required
    - `amount` number, double, required — The airtime amount to be purchased
    - `timeCreated` string, date-time, required — The Date and Time of transaction creation
    - `type` string, required — The classification for this type of transaction
    - `meta` object — Extra information about this transaction
    - `status` string, required — The system status of this transction

## Other responses

- `400` — The request body sent by merchant did not pass the validation checks
- `401` — The access_token provided to access the resource is missing or invalid.
- `403` — The client does not have the permissions to access this resource
- `404` — The record that the client is trying to access does not exist.
- `429` — The client has maxed out the number of calls within a time period on this resource.
- `500` — Downstream system error.
- `default` — Resource not available

---

[API](https://skmtc.net/nomba/apis/vendor-api.md) · [All operations](https://skmtc.net/nomba/apis/vendor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nomba/vendor-api/revisions/41727ac9be5f/schema)