How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

MTN Customer Delivery Booking

To retrieve and schedule delivery information for MTN Customers.

MTN Customer Delivery Booking is one of 119 APIs that MTN Group publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Customers and South Africa. The published artifact set on APIs.io includes API documentation, an API reference, and an OpenAPI specification.

This API exposes 9 operations across 9 paths, organized into 2 resource areas, and defines 22 schemas. It is described by OpenAPI 2.0, at version v1.0.

Requests are made against the base URL https://api.mtn.com/v1.

9 operations 9 paths 22 schemas 6 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
v1.0
Base URL
https://api.mtn.com/v1
Authentication
API Key, OAuth 2.0
Resource Areas
2

Authentication & Security 2

MTN Customer Delivery Booking declares 2 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). It supports OAuth 2.0 (OAuth2) using the application flow. By default, every request must be authenticated.

Paths & Operations 9

Across 9 paths, the API surfaces 9 operations — 6 GET, 3 POST. They span 2 resource areas: Reference Data Operations, Process Operations. Each is listed below with its method, path, parameters, and response codes.

Reference Data Operations 3
GET
/booking/province
To retrieve the list of provinces available in the system
Province 1 param → 200400401403404405500
GET
/booking/town
To retrieve the list of towns available in the system
Town 1 param → 200400401403404405500
GET
/booking/suburb
To retrieve the list of suburb available in the system
Suburb 3 params → 200400401403404405500
Process Operations 6
GET
/booking/bookingAvailability
To retrieve the booking availability
Booking Availability 10 params → 200400401403404405500
POST
/booking/externalBooking
To validate the booking
External Booking 2 params → 200400401403404405500
GET
/booking/getBooking
To update or cancel a booking
Booking update 6 params → 200400401403404405500
POST
/booking/cancelBooking
To cancel a booking request
Cancel Booking 2 params → 200400401403404405500
GET
/booking/findBooking
To track a booking
Track Booking 6 params → 200400401403404405500
POST
/booking/updateBooking
To validate booking by Administrator
Update Booking 2 params → 200400401403404405500

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are bookingRequest (47 properties), bookingRequests (47 properties), updateBookingRequest (39 properties), externalBookingRequest (38 properties). Each schema is shown below with its type and property counts.

provinceResponse
object
5 properties
provinceList
object
2 properties
townResponse
object
5 properties
townList
object
3 properties
suburbResponse
object
5 properties
suburbList
object
5 properties
bookingAvailabilityResponse
object
5 properties
bookingAvailabilitySlots
object
7 properties
serviceDays
object
18 properties
timeSlots
string
externalBookingRequest
object
38 properties
externalBookingResponse
object
5 properties
getBookingResponse
object
5 properties
bookingRequest
object
47 properties
messages
object
1 property
cancelBookingRequest
object
5 properties
cancelBookingResponse
object
4 properties
findBookingResponse
object
5 properties
bookingRequests
object
47 properties
updateBookingRequest
object
39 properties
updateBookingResponse
object
4 properties
Error
object
6 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mtn-group-customer-delivery-booking.yml Raw ↑

Other APIs MTN Group publishes across the network.

MTN Account Decisioning
MTN TMF Customer Bill Management - TMF678
MTN Loans
MTN Subscriber Details
MTN Subscriber Type
MTN Provisioning
MTN Unified Balance V1
MTN TMF Resource Inventory Management - TMF639
MTN Sales Lead
MTN Service Activation and Configuration
MTN Service Ordering
MTN BSS TT OAuth V1
Where this information came from

This is an independent, third-party profile of MTN Customer Delivery Booking, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.