Look up an Msisdn

Looks up information associated with the given Msisdn. This includes such information as available products and promotions, operator information etc.

Request
Security:
query Parameters
msisdn
required
string

The Msisdn. This must conform to the ITU E.164 numbering plan (https://www.itu.int/rec/T-REC-E.164/en).

senderMsisdn
string

The sender Msisdn. The MSISDN from which the request originated. This must conform to the ITU E.164 numbering plan (https://www.itu.int/rec/T-REC-E.164/en).

operator
string

The provider who processed the original purchase attempt.

productType
string

Used to filter the products to lookup for a given msisdn. This should be a value appropriate for the Product.type field.

channelName
string

Used to filter the products to lookup for a given channel.

productCategory
string

Used to filter the products to lookup within a specific category. The productType field should be used preferentially if applicable. An example of a relevant productCategory would be the name of a promotion if only products within a specific promotion should be retrieved.

Responses
200

Accepted

400

Bad Request

404

Not Found

500

Internal Server Error

503

Service Unavailable

504

Gateway Timeout

get/msisdn
Request samples
curl -i -X GET \
  -u <username>:<password> \
  'https://sandbox.electrum.io/airtime/v5/msisdn?msisdn=string&senderMsisdn=string&operator=string&productType=string&channelName=string&productCategory=string'
Response samples
application/json
{
  • "msisdn": {
    },
  • "senderMsisdn": {
    },
  • "amounts": {
    },
  • "promotion": {
    },
  • "availableProducts": [
    ]
}
Copyright © Electrum Payments (Pty) Ltd. 2019-2022. All right reserved.