# MTN Group Customers API

**Canonical:** https://apis.io/apis/mtn-group/mtn-group-customers-api/  
**Provider:** MTN Group — https://apis.io/providers/mtn-group/  
**Base URL:** https://api.mtn.com/accountDecisioning/v1  
**Documentation:** https://developers.mtn.com/products/account-decisioning

MTN Group Customers API is one of 148 APIs that [MTN Group](https://apis.io/providers/mtn-group/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Customers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Customers API from MTN Group — 21 operation(s) for customers.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| POST | `/customers/{customerId}/loans/advance` | Gets a loan advance. |
| GET | `/customers/{customerId}/loans/advance/status` | Gets loan advance status. |
| GET | `/customers/{customerId}/loans/eligibleBundle` | Retrieves the list of eligible loan. |
| GET | `/customers/{customerId}/locations` | View customer locations |
| GET | `/customers/{id}/plans/FRI` | Retrieves a customers FRI |
| PATCH | `/customers/{id}/plans/FRI/state` | Block and Unblock operations are initiated on Customer FRI |
| GET | `/customers/{customerId}/plans` | View customer plans |
| PATCH | `/customers/{customerId}/plans` | Tariff plan migration |
| GET | `/customers/{customerId}/plans/{productCode}` | View customer plans for product |
| PATCH | `/customers/{customerId}/plans/refill` | Airtime Refill |
| POST | `/customers/{id}/plans/provision` | Provision the customer and return customer details along with MSISDN |
| GET | `/customers/{customerId}` | View customer profile |
| GET | `/customers/upgrade-eligibility/{customerId}` | Get customer’s upgrade eligibility |
| GET | `/customers/{customerId}/tenure` | Get customer’s tenure |
| GET | `/customers/{customerId}/activityStatus` | Get customer’s activity status |
| GET | `/customers/{customerId}/score` | Get Customer score. |
| POST | `/customers/{customerId}/score/creditinfo` | Sends Credit Information to CRC |
| GET | `/customers/{customerId}/subscriptions` | List all Subscriptions |
| POST | `/customers/{customerId}/subscriptions` | Subscribe the customer to a new service |
| DELETE | `/customers/{customerId}/subscriptions` | Unsubscribe All Subscriptions for a Customer |
| GET | `/customers/{customerId}/subscriptions/{subscriptionId}` | Get Subscription details |
| DELETE | `/customers/{customerId}/subscriptions/{subscriptionId}` | Unsubscribe a specific subscription |
| GET | `/customers/{customerId}/subscriptions/{subscriptionId}/status/{statusId}` | Get provisioning status of a recently added Subscription |
| GET | `/customers/{customerId}/subscriptions-providers` | Retrieve subscription providers |
| GET | `/customers/list/subscriptions` | List of offers per menu code |

## Machine-readable artifacts (231)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/mtn-group/refs/heads/main/openapi/mtn-group-customers-api-openapi.yml
- **Documentation** — https://developers.mtn.com/products/account-decisioning
- **APIReference** — https://developers.mtn.com/products/account-decisioning
- **Documentation** — https://developers.mtn.com/products/tmf-customer-bill-management
- **APIReference** — https://developers.mtn.com/products/tmf-customer-bill-management
- **Documentation** — https://developers.mtn.com/products/mtn-customer-loans-api-v1
- **APIReference** — https://developers.mtn.com/products/mtn-customer-loans-api-v1
- **Documentation** — https://developers.mtn.com/products/subscriber-details
- **APIReference** — https://developers.mtn.com/products/subscriber-details
- **Documentation** — https://developers.mtn.com/products/subscriber-type
- **APIReference** — https://developers.mtn.com/products/subscriber-type
- **Documentation** — https://developers.mtn.com/products/provisioning
- **APIReference** — https://developers.mtn.com/products/provisioning
- **Documentation** — https://developers.mtn.com/products/unified-balance-v1
- **APIReference** — https://developers.mtn.com/products/unified-balance-v1
- **Documentation** — https://developers.mtn.com/products/tmf-resourceinventorymanagement-tmf639
- **APIReference** — https://developers.mtn.com/products/tmf-resourceinventorymanagement-tmf639
- **Documentation** — https://developers.mtn.com/products/sales-management
- **APIReference** — https://developers.mtn.com/products/sales-management
- **Documentation** — https://developers.mtn.com/products/service-activation-and-configuration
- **APIReference** — https://developers.mtn.com/products/service-activation-and-configuration
- **Documentation** — https://developers.mtn.com/products/service-ordering
- **APIReference** — https://developers.mtn.com/products/service-ordering
- **Documentation** — https://developers.mtn.com/products/bss-tt-oauth-v1
- **APIReference** — https://developers.mtn.com/products/bss-tt-oauth-v1
- **Documentation** — https://developers.mtn.com/products/balance-management-v1
- **APIReference** — https://developers.mtn.com/products/balance-management-v1
- **Documentation** — https://developers.mtn.com/products/callmeback-v1
- **APIReference** — https://developers.mtn.com/products/callmeback-v1
- **Documentation** — https://developers.mtn.com/products/callmeback-v2
- **APIReference** — https://developers.mtn.com/products/callmeback-v2
- **Documentation** — https://developers.mtn.com/products/rcs-communication
- **APIReference** — https://developers.mtn.com/products/rcs-communication
- **Documentation** — https://developers.mtn.com/products/communication-management-v1
- **APIReference** — https://developers.mtn.com/products/communication-management-v1
- **Documentation** — https://developers.mtn.com/products/tmf681-communication-management
- **APIReference** — https://developers.mtn.com/products/tmf681-communication-management
- **Documentation** — https://developers.mtn.com/products/ayo-preapproval
- **APIReference** — https://developers.mtn.com/products/ayo-preapproval
- **Documentation** — https://developers.mtn.com/products/content-push
- …and 191 more, listed in full on the page.

## Other MTN Group APIs (12)

- [MTN MoMo Collection API](https://apis.io/apis/mtn-group/momo-collection/)
- [MTN MoMo Disbursements API](https://apis.io/apis/mtn-group/momo-disbursement/)
- [MTN MoMo Remittance API](https://apis.io/apis/mtn-group/momo-remittance/)
- [MTN MoMo Sandbox User Provisioning API](https://apis.io/apis/mtn-group/momo-sandbox-user-provisioning/)
- [MTN Group Accessible to 3PP API](https://apis.io/apis/mtn-group/mtn-group-accessible-to-3pp-api/)
- [MTN Group Accessible to USSD Gateway API](https://apis.io/apis/mtn-group/mtn-group-accessible-to-ussd-gateway-api/)
- [MTN Group Activation API](https://apis.io/apis/mtn-group/mtn-group-activation-api/)
- [MTN Group Add User API](https://apis.io/apis/mtn-group/mtn-group-add-user-api/)
- [MTN Group Admin Suspend API](https://apis.io/apis/mtn-group/mtn-group-admin-suspend-api/)
- [MTN Group Adverts API](https://apis.io/apis/mtn-group/mtn-group-adverts-api/)
- [MTN Group Advice Reconcile API](https://apis.io/apis/mtn-group/mtn-group-advice-reconcile-api/)
- [MTN Group Agents API](https://apis.io/apis/mtn-group/mtn-group-agents-api/)

## Tags

Customers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mtn-group/mtn-group-customers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mtn-group/.