Tata Communications

Number Intelligence API

Queries the number-lookup details of any E.164 number and returns subscriber type, the current and parent network, the port-corrected service provider network (SPN), and MCC/MNC when the number is mobile, so a sender can decide whether to route traffic to a fixed or mobile destination. Publicly visible on the Tata Communications developer portal with a downloadable Swagger 2.0 document; 2 operations across 2 paths.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.tatacommunications.com/#/api/0cd4be86-167c-4770-9459-e68fe925f63a.tcl
📖
APIReference
https://developer.tatacommunications.com/#/api/0cd4be86-167c-4770-9459-e68fe925f63a.tcl/versions/9c14d794-576f-4d76-a930-7ba00f38c714.tcl

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tata-communications/refs/heads/main/openapi/tata-communications-number-intelligence-api.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/tata-communications/refs/heads/main/overlays/tata-communications-number-intelligence-api-overlay.yaml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/tata-communications/refs/heads/main/apis.yml

OpenAPI Specification

tata-communications-number-intelligence-api.json Raw ↑ 
{"swagger":"2.0","info":{"description":"Query the number lookup details of any E.164 number. It provides the type of subscriber, current and parent network and MCCMNC if type Mobile. It returns the type of connection i.e fixed or mobile which allows the customer to send traffic to mobile sub.","version":"1.0","title":"Number Intelligence API"},"paths":{"/number/{phnum}":{"get":{"tags":["Number Intelligence"],"summary":"number lookup details","description":"get the routing details of a given number","operationId":"numberLookupDetails","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Authorization","in":"header","description":"used for authentication in Akana","required":true,"type":"string"},{"name":"phnum","in":"path","description":"subscriber number either fixed or mobile","required":true,"type":"string"}],"responses":{"200":{"description":"success response","schema":{"properties":{"queriedNumber":{"type":"string","description":"subscriber number"},"result":{"type":"object","description":"response object","properties":{"npdi":{"type":"string","description":"Number Portability Dip Indicator"},"spn":{"type":"string","description":"Service Provider Network Represents the identity of the port-corrected operator serving the TN"},"altSpn":{"type":"string","description":"Alternative SPN Represents the identity of the port-corrected operator serving the TN when the SPN alone is insufficient"},"mcc":{"type":"string","description":"Mobile Country Code; a three-digit code assigned to a country that is the first part of the identity as defined in ITU E.212 Recommendation"},"mnc":{"type":"string","description":"Mobile Network Code; a two or three-digit code under an MCC assigned to a Mobile Operator that is the second part of the identity as defined in ITU E.212 Recommendation."},"name":{"type":"string","description":"Mobile operator name or not.    "},"queryStatus":{"type":"string","description":"Query Status Code"},"description":{"type":"string","description":"Query Status Description"}}}},"description":"number lookup attributes generated"}},"400":{"description":"Request formatting error","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"401":{"description":"Customer couldn't be authenticated","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"500":{"description":"Service Unavailable","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"403":{"description":"Customer has been authenticated but customer isn't having access on the requested data","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"404":{"description":"No data present for the queried TN","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}}}}},"/records":{"get":{"tags":["Number Intelligence"],"summary":"number lookup records of the user","description":"get the number lookup history transactions of the user going back to last 180 days maximum","operationId":"numberLookupRecords","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Authorization","in":"header","description":"used for authentication in Akana","required":true,"type":"string"},{"name":"pageNo","in":"query","description":"page number of the record","required":false,"type":"integer"},{"name":"pageSize","in":"query","description":"total records in a page. By default, page size would be 100. Maximum allowed size is 100","required":false,"type":"integer"}],"responses":{"200":{"description":"success response","schema":{"properties":{"queriedUserid":{"type":"string","description":"akana appid of the user"},"totalRecords":{"type":"integer","description":"total number of records of the user"},"result":{"type":"array","description":"response array","items":{"type":"object","description":"response object","properties":{"timestamp":{"type":"string","description":"timestamp of the transaction. for eg. 10 Jan 2021 12:12:09"},"number":{"type":"string","description":"telephone number"},"npdi":{"type":"string","description":"Number Portability Dip Indicator"},"spn":{"type":"string","description":"Service Provider Network Represents the identity of the port-corrected operator serving the TN"},"altSpn":{"type":"string","description":"Alternative SPN Represents the identity of the port-corrected operator serving the TN when the SPN alone is insufficient"},"mcc":{"type":"string","description":"Mobile Country Code; a three-digit code assigned to a country that is the first part of the identity as defined in ITU E.212 Recommendation"},"mnc":{"type":"string","description":"Mobile Network Code; a two or three-digit code under an MCC assigned to a Mobile Operator that is the second part of the identity as defined in ITU E.212 Recommendation."},"name":{"type":"string","description":"Mobile operator name or not.    "},"queryStatus":{"type":"string","description":"Query Status Code"},"description":{"type":"string","description":"Query Status Description"}}}}},"description":"number lookup attributes generated"}},"400":{"description":"Request formatting error","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"401":{"description":"Customer couldn't be authenticated","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"500":{"description":"Service Unavailable","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"403":{"description":"Customer has been authenticated but customer isn't having access on the requested data","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}},"404":{"description":"No data present for the queried TN","schema":{"properties":{"responseCode":{"type":"integer","description":"error status code"},"responseText":{"type":"string","description":"error message text"}}}}}}}},"definitions":{}}