Subscriptions v1

AVAILABLE IN

Cameroon Ghana Liberia Nigeria South Sudan Eswatini Uganda South Africa Zambia

Download

Download Postman collection Download Swagger

Available endpoints

GET api/customers/{id}/subscriptions

Description

Get a Customer's Subscriptions given the Customer's id

Header parameters

Content-Type application/json

Auth parameters

apikey X-API-Key
200OK
systems
systemId string
status string
statusCode string
message string
subscriptionList
subscriptionId string
Unique system identifier for the Subsription
systemId string
Identifier for the system within which the Subscription lives
subscriptionName string
Service the customer is subscribed to
subscriptionStatus string
Active,Inactive
subscriptionDescription string
Description of the service the customer is subscribed to
subscriptionType string
Adhoc,Recurring
subscriptionLength string
Duration of the subscription the customer is subscribed to
registrationChannel string
Channel through which the customer subscribed to the service
startDate string
Start date of the Subscription; full-date notation RFC 3339
endDate string
End date of the Subscription; full-date notation RFC 3339
email string
Email associated with the subcription 
{
    "systems": {
        "systemId": "string",
        "status": "string",
        "statusCode": "string",
        "message": "string"
    },
    "subscriptionList": {
        "subscriptionId": "string",
        "systemId": "string",
        "subscriptionName": "string",
        "subscriptionStatus": "string",
        "subscriptionDescription": "string",
        "subscriptionType": "string",
        "subscriptionLength": "string",
        "registrationChannel": "string",
        "startDate": "string",
        "endDate": "string",
        "email": "string"
    }
}
206Partial Content
systems
systemId string
status string
statusCode string
message string
subscriptionList
subscriptionId string
Unique system identifier for the Subsription
systemId string
Identifier for the system within which the Subscription lives
subscriptionName string
Service the customer is subscribed to
subscriptionStatus string
Active,Inactive
subscriptionDescription string
Description of the service the customer is subscribed to
subscriptionType string
Adhoc,Recurring
subscriptionLength string
Duration of the subscription the customer is subscribed to
registrationChannel string
Channel through which the customer subscribed to the service
startDate string
Start date of the Subscription; full-date notation RFC 3339
endDate string
End date of the Subscription; full-date notation RFC 3339
email string
Email associated with the subcription 
{
    "systems": {
        "systemId": "string",
        "status": "string",
        "statusCode": "string",
        "message": "string"
    },
    "subscriptionList": {
        "subscriptionId": "string",
        "systemId": "string",
        "subscriptionName": "string",
        "subscriptionStatus": "string",
        "subscriptionDescription": "string",
        "subscriptionType": "string",
        "subscriptionLength": "string",
        "registrationChannel": "string",
        "startDate": "string",
        "endDate": "string",
        "email": "string"
    }
}
400Bad Request
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
403Forbidden
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
404Not Found
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
405Method Not Allowed
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
500Internal Server Error
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
GET api/customers/{id}/subscriptions/{subscriptionId}

Description

Retrieve specific subscription details for a customer

Header parameters

Content-Type application/json

Auth parameters

apikey X-API-Key

Query parameters

systemId string required
Identify the system hosting the subscription
200OK
subscriptionId string
Unique system identifier for the Subsription
systemId string
Identifier for the system within which the Subscription lives
subscriptionName string
Service the customer is subscribed to
subscriptionStatus string
Active,Inactive
subscriptionDescription string
Description of the service the customer is subscribed to
subscriptionType string
Adhoc,Recurring
subscriptionLength string
Duration of the subscription the customer is subscribed to
registrationChannel string
Channel through which the customer subscribed to the service
startDate string
Start date of the Subscription; full-date notation RFC 3339
endDate string
End date of the Subscription; full-date notation RFC 3339
email string
Email associated with the subcription 
{
    "subscriptionId": "string",
    "systemId": "string",
    "subscriptionName": "string",
    "subscriptionStatus": "string",
    "subscriptionDescription": "string",
    "subscriptionType": "string",
    "subscriptionLength": "string",
    "registrationChannel": "string",
    "startDate": "string",
    "endDate": "string",
    "email": "string"
}
400Bad Request
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
403Forbidden
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
404Not Found
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
405Method Not Allowed
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
500Internal Server Error
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
DELETE api/customers/{id}/subscriptions/{subscriptionId}

Description

Delete a specific subscription

Header parameters

Content-Type application/json

Auth parameters

apikey X-API-Key

Query parameters

systemId string required
Identify the system hosting the subscription
200OK
status string
Unsubscribe successful,Unsubscribe unsucccessful
description string
Details on result of the unsubscribe action 
{
    "status": "string",
    "description": "string"
}
400Bad Request
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
403Forbidden
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
404Not Found
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
405Method Not Allowed
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}
500Internal Server Error
responseCode string
Error response code
reason string
Text explaining the reason for the error
message string
More error details and corrective measures 
{
    "responseCode": "string",
    "reason": "string",
    "message": "string"
}

Check out some of our other products.

MTN

Product Offering v2

View the product

rw flag
View
MTN

Transaction Summaries v1

View the product

ug flag
View
MTN

MTN Nigeria Customer Datashare

No auto approval - 3pp senderMsisdn to be added on App

ng flag
View