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/tmt-id-http-api-v2-0-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

openapi: 3.2.0
info:
  title: TMT Teleshield API specs HTTP API v2.0 API
  termsOfService: https://viteza.tmtid.com/download-terms-and-conditions
  contact:
    name: TMT Support
    email: support@tmtid.com
    url: https://www.tmtid.com
  x-logo:
    url: https://www.tmtid.com/developer/teleshield_logo_png.png
    altText: TMT Teleshield
  version: '1.0'
servers:
- url: https://api.tmtid.com
tags:
- name: HTTP API v2.0
paths:
  /r-teleshield/{number}:
    post:
      tags:
      - HTTP API v2.0
      summary: TeleShield Routing
      operationId: POST
      description: ''
      parameters:
      - name: X-API-Key
        in: header
        description: Your apikey (delivered via email).
        required: true
        schema:
          type: string
      - name: X-API-Secret
        in: header
        description: Your apisecret (delivered via email).
        required: true
        schema:
          type: string
      - name: number
        in: path
        required: true
        description: The number in E.164 format (includes the country code sufix).
        schema:
          type: string
      responses:
        '200':
          headers: {}
          content:
            application/json:
              examples:
                TeleShield Routing Successful Command and Response Example:
                  value:
                    number: 40766610060
                    cc: RO
                    ocic: 4018760
                    oocn: null
                    itype: 1
                    etype: 10
                    omcc: '226'
                    omnc: '03'
                    original_network: Telekom Romania Mobile (Cosmote)
                    error: 0
                    trxid: Pp2dxrl
                TeleShield Routing Status Message for Invalid Credentials input (apikey/apisecret):
                  value:
                    number: 40721275636
                    status_message: Service or destination not authorized
                    status: 2
                TeleShield Routing Error response for a number that belongs to a Denied Destination:
                  value:
                    number: 40721275636
                    error: 254
                    error_message: no auth
                Input number has no Country Code match:
                  value:
                    number: 999999
                    error: 1
                    error_message: invalid number
                Input number has the wrong length:
                  value:
                    number: 407225702400
                    error: 2
                    error_message: invalid number length
                Input number is not part of an allocated range from the regulator:
                  value:
                    number: 40999123233
                    error: 3
                    error_message: invalid number range
              schema:
                type: object
                properties:
                  number:
                    type: number
                    description: The telephone number queried
                  cc:
                    type: string
                  ocic:
                    type: number
                  oocn:
                    type: string
                  itype:
                    type: number
                  etype:
                    type: number
                  omcc:
                    type: number
                  omnc:
                    type: number
                  original_network:
                    type: string
                  error:
                    type: number
                  trxid:
                    type: string
          description: ''
  /f-teleshield/{number}:
    post:
      tags:
      - HTTP API v2.0
      summary: TeleShield Fraud
      operationId: POST
      description: ''
      parameters:
      - name: X-API-Key
        in: header
        description: Your apikey (delivered via email).
        required: true
        schema:
          type: string
      - name: X-API-Secret
        in: header
        description: Your apisecret (delivered via email).
        required: true
        schema:
          type: string
      - name: number
        in: path
        required: true
        description: The number in E.164 format (includes the country code sufix).
        schema:
          type: string
      responses:
        '200':
          headers: {}
          content:
            application/json:
              examples:
                TeleShield Fraud Successful Command and Response Example:
                  value:
                    number: 247490XX
                    cc: AC,
                    ocic: 247501
                    oocn: null
                    itype: 1
                    etype: 10
                    omcc: '658'
                    omnc: '01'
                    original_network: Sure South Atlantic
                    iprn_number: true
                    iprn_number_first_seen: '2023-02-07'
                    iprn_number_last_seen: '2023-02-07'
                    iprn_wildcard: true
                    iprn_wildcard_first_seen: '2023-02-07'
                    iprn_wildcard_last_seen: '2023-06-20'
                    msrn: true
                    msrn_first_seen: '2023-02-07'
                    msrn_last_seen: '2023-02-07'
                    ts: 25
                    tl: M
                    error: 0
                    trxid: u621Kb3
                TeleShield Fraud Status message for Invalid Credentials (apikey/apisecret):
                  value:
                    number: 40722570240
                    status_message: Service or destination not authorized
                    status: 2
                TeleShield Fraud Error response for a number that belongs to a Denied Destination:
                  value:
                    number: 40722570240
                    error: 254
                    error_message: no auth
                Input number has no Country Code match:
                  value:
                    number: 999999
                    ts: 100
                    tl: H
                    error: 1
                    error_message: invalid number
                Input number has the wrong length:
                  value:
                    number: 4077
                    ts: 100
                    tl: H
                    error: 2
                    error_message: invalid number length
                Input number is not part of an allocated range from the regulator:
                  value:
                    number: 40999123233
                    ts: 100
                    tl: H
                    error: 3
                    error_message: invalid number range
              schema:
                type: object
                properties:
                  number:
                    type: number
                    description: The telephone number queried
                  cc:
                    type: string
                  ocic:
                    type: number
                  oocn:
                    type: string
                  itype:
                    type: number
                  etype:
                    type: number
                  omcc:
                    type: number
                  omnc:
                    type: number
                  original_network:
                    type: string
                  iprn_number:
                    type: boolean
                  iprn_number_first_seen:
                    type: date
                  iprn_number_last_seen:
                    type: date
                  iprn_wildcard:
                    type: boolean
                  iprn_wildcard_first_seen:
                    type: date
                  iprn_wildcard_last_seen:
                    type: date
                  msrn:
                    type: boolean
                  msrn_first_seen:
                    type: date
                  msrn_last_seen:
                    type: date
                  ts:
                    type: number
                  tl:
                    type: string
                  error:
                    type: number
                  trxid:
                    type: string
          description: ''
  /e-teleshield/{number v2.0}:
    post:
      tags:
      - HTTP API v2.0
      summary: TeleShield Enhanced Fraud
      operationId: POST
      description: ''
      parameters:
      - name: X-API-Key
        in: header
        description: Your apikey (delivered via email).
        required: true
        schema:
          type: string
      - name: X-API-Secret
        in: header
        description: Your apisecret (delivered via email).
        required: true
        schema:
          type: string
      - name: number
        in: path
        required: true
        description: The number in E.164 format (includes the country code sufix).
        schema:
          type: string
      responses:
        '200':
          headers: {}
          content:
            application/json:
              examples:
                TeleShield Fraud Successful Command and Response Example:
                  value:
                    number: 40766610060
                    cc: RO
                    ocic: 4018760
                    oocn: null
                    itype: 1
                    etype: 10
                    omcc: '226'
                    omnc: '03'
                    original_network: Telekom Romania Mobile (Cosmote)
                    ported: false
                    ported_date: '2017-11-23'
                    cic: 4018760
                    ocn: ''
                    mcc: 226
                    mnc: 3
                    network: Telekom Romania Mobile (Cosmote)
                    present: 'yes'
                    iprn_number: false
                    iprn_wildcard: false
                    msrn: false
                    ts: 0
                    tl: L
                    error: 0
                    trxid: Q4iRYrT
                TeleShield Enhanced Fraud Status message for Invalid Credentials (apikey/apisecret):
                  value:
                    number: 40722570240
                    status_message: Service or destination not authorized
                    status: 2
                TeleShield Enhanced Fraud Error response for a number that belongs to a Denied Destination:
                  value:
                    number: 40722570240
                    error: 254
                    error_message: no auth
                Input number has no Country Code match:
                  value:
                    number: 999999
                    ts: 100
                    tl: H
                    error: 1
                    error_message: invalid number
                Input number has the wrong length:
                  value:
                    number: 4077
                    ts: 100
                    tl: H
                    error: 2
                    error_message: invalid number length
                Input number is not part of an allocated range from the regulator:
                  value:
                    number: 40999123233
                    ts: 100
                    tl: H
                    error: 3
                    error_message: invalid number range
                Available Number Portability (np) / Unavailable Presence:
                  value:
                    number: 23470100000xx
                    cc: NG
                    ocic: 234500
                    oocn: null
                    itype: 1
                    etype: 10
                    omcc: '621'
                    omnc: '20'
                    original_network: Airtel
                    ported: true
                    ported_date: '2020-10-11'
                    cic: 234503
                    ocn: null
                    mcc: 621
                    mnc: 60
                    network: 9Mobile (ETISALAT/Emerging Markets)
                    present: na
                    iprn_number: false
                    iprn_wildcard: false
                    msrn: false
                    ts: 5
                    tl: L
                    error: 4
                    error_message: presence not available
                    trxid: BiiN7LJ
                Unavailable Number Portability (np) / Unavailable Presence:
                  value:
                    number: 9230440783xx
                    cc: PK
                    ocic: 92500
                    oocn: null
                    itype: 1
                    etype: 10
                    omcc: '410'
                    omnc: '01'
                    original_network: Jazz (Mobilink)
                    cic: 92500
                    ocn: null
                    mcc: 410
                    mnc: 1
                    network: Jazz (Mobilink)
                    present: na
                    iprn_number: false
                    iprn_wildcard: false
                    msrn: false
                    ts: 0
                    tl: L
                    error: 5
                    error_message: presence not available
                    trxid: pximuMp
              schema:
                type: object
                properties:
                  number:
                    type: number
                    description: The telephone number queried
                  cc:
                    type: string
                  ocic:
                    type: number
                  oocn:
                    type: string
                  itype:
                    type: number
                  etype:
                    type: number
                  omcc:
                    type: number
                  omnc:
                    type: number
                  original_network:
                    type: string
                  ported:
                    type: boolean
                  ported_date:
                    type: date
                  cic:
                    type: number
                  ocn:
                    type: string
                  mcc:
                    type: number
                  mnc:
                    type: number
                  network:
                    type: string
                  present:
                    type: string
                  iprn_number:
                    type: boolean
                  iprn_wildcard:
                    type: boolean
                  msrn:
                    type: boolean
                  ts:
                    type: number
                  tl:
                    type: string
                  error:
                    type: number
                  trxid:
                    type: string
          description: ''
x-tagGroups:
- name: Introduction
  tags:
  - Version history
  - About TMT
- name: Service Specifications v2.0
  tags:
  - TMT TeleShield v2.0 Overview
  - Data Dictionary v2.0
  - HTTP API v2.0
  - ENUM TeleShield Routing v2.0
  - ENUM TeleShield Fraud v2.0
  - ENUM TeleShield Enhanced Fraud v2.0
- name: Service Specifications v1.3
  tags:
  - Data Dictionary v1.3
  - HTTP API v1.3
  - ENUM Services v1.3
- name: Other Specifications
  tags:
  - SIP Redirect
  - Batch Service – Portal access
  - Operator files