Tata Communications

Tata Communications Number Intelligence API

The Number Intelligence API from Tata Communications — 2 operation(s) for number intelligence.

GitHub OpenAPI

Operations 2

GET /number/{phnum} number lookup details #
GET /records number lookup records of the user #

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
📖
Documentation
https://developer.tatacommunications.com/#/api/5d771bb7-97eb-4e36-bf9d-9edd3d51baa8.tcl
📖
APIReference
https://developer.tatacommunications.com/#/api/5d771bb7-97eb-4e36-bf9d-9edd3d51baa8.tcl/versions/976eb113-e9b9-4af7-8e54-842fde470bb1.tcl
📖
Documentation
https://developer.tatacommunications.com/#/api/eef35c15-1259-4b32-8d00-19b8b913ce2d.tcl
📖
APIReference
https://developer.tatacommunications.com/#/api/eef35c15-1259-4b32-8d00-19b8b913ce2d.tcl/versions/70989384-2a73-44d3-8925-8ca108c061b0.tcl

Specifications

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

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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

tata-communications-number-intelligence-api-openapi.yml Raw ↑ 
openapi: 3.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
tags:
- name: Number Intelligence
paths:
  /number/{phnum}:
    get:
      tags:
      - Number Intelligence
      summary: number lookup details
      description: get the routing details of a given number
      operationId: numberLookupDetails
      parameters:
      - name: Authorization
        in: header
        description: used for authentication in Akana
        required: true
        schema:
          type: string
      - name: phnum
        in: path
        description: subscriber number either fixed or mobile
        required: true
        schema:
          type: string
      responses:
        '200':
          description: success response
          content:
            application/json:
              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
          content:
            application/json:
              schema:
                properties:
                  responseCode:
                    type: integer
                    description: error status code
                  responseText:
                    type: string
                    description: error message text
        '401':
          description: Customer couldn't be authenticated
          content:
            application/json:
              schema:
                properties:
                  responseCode:
                    type: integer
                    description: error status code
                  responseText:
                    type: string
                    description: error message text
        '500':
          description: Service Unavailable
          content:
            application/json:
              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
          content:
            application/json:
              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
          content:
            application/json:
              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
      parameters:
      - name: Authorization
        in: header
        description: used for authentication in Akana
        required: true
        schema:
          type: string
      - name: pageNo
        in: query
        description: page number of the record
        required: false
        schema:
          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
        schema:
          type: integer
      responses:
        '200':
          description: success response
          content:
            application/json:
              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
          content:
            application/json:
              schema:
                properties:
                  responseCode:
                    type: integer
                    description: error status code
                  responseText:
                    type: string
                    description: error message text
        '401':
          description: Customer couldn't be authenticated
          content:
            application/json:
              schema:
                properties:
                  responseCode:
                    type: integer
                    description: error status code
                  responseText:
                    type: string
                    description: error message text
        '500':
          description: Service Unavailable
          content:
            application/json:
              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
          content:
            application/json:
              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
          content:
            application/json:
              schema:
                properties:
                  responseCode:
                    type: integer
                    description: error status code
                  responseText:
                    type: string
                    description: error message text