Network Lookup Service

The Network Lookup Service allows you to identify the carrier and time zone associated with a given phone number. This can be particularly useful for validating mobile network operators before processing transactions.

Request

Request Headers

  • Content-Type: application/json
  • Authorization: Bearer YOUR_ACCESS_TOKEN​
    Refer to this link to fetch the token.

Request Body Parameters

ParameterTypeDescriptionRequired
countryCodestringCountry ISO code letter, i.e., KE,GH,TZyes
numberstringCustomer mobile numberyes

Sample Request

curl --location 'https://api-dev.tingg.africa/v4/remittance/payments/network-lookup' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "countryCode": "KE",
    "number": "254775850798"
}'

Response

Response Parameters

  • carrier (string): The name of the mobile network operator associated with the provided phone number.​
  • timeZone (string): The time zone corresponding to the phone number's region.

Sample Response

{
    "carrier": "Telkom",
    "timeZone": "Africa/Nairobi"
}
{
    "data": null,
    "message": "Jwt expired at 2025-04-04T08:42:27Z",
    "success": false,
    "statusCode": 131
}
{
    "errorCode": 400,
    "errorDescription": "The string supplied did not seem to be a phone number."
}
Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!