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.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/tata-communications-number-intelligence-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

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":{}}