Bharti Airtel

Bharti Airtel Whitelisting API

This set of APIs to manage whitelisting numbers on Airtel IoT portal in Batch

GitHub OpenAPI

Operations 3

GET /wt/numbers Fetch SMS Whitelisted Number #
POST /wt/numbers/batch SMS Batch Whitelisting API #
GET /voice/numbers Fetch Voice Whitelist Numbers from CMP #

Documentation

📖
Documentation
https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/overview
📖
APIReference
https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/sms-utility
📖
Documentation
https://www.airtel.in/business/b2b/airtel-iq/api-docs/voice/overview
📖
APIReference
https://www.airtel.in/business/b2b/airtel-iq/api-docs/voice/sample-cdr
📖
Documentation
https://www.airtel.in/m2m/business/b2b/m2m-solutions/documentation/m2m-solutions/
📖
APIReference
https://www.airtel.in/m2m/business/b2b/m2m-solutions/documentation/m2m-solutions/
📖
Documentation
https://www.airtel.in/m2m/business/b2b/locate-solution/documentation/locate-solution/
📖
APIReference
https://www.airtel.in/m2m/business/b2b/locate-solution/documentation/locate-solution/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bharti-airtel/refs/heads/main/openapi/bharti-airtel-whitelisting-api-openapi.yml

Other Resources

🔗
SignUp
https://www.airtel.in/business/b2b/airtel-ccp/dashboard/#/signup

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/bharti-airtel-whitelisting-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

bharti-airtel-whitelisting-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: ''
  title: Airtel IoT Whitelisting API
  contact:
    email: m2m.support@airtel.com
  description: '# Overview

    ## Introduction


    Airtel IoT Developer Portal showcases APIs that allows you

    to access data of the CMP Billable account from any external application.'
servers:
- url: https://m2m.airteliot.co.in/iot/api/
security: []
tags:
- name: Whitelisting
  description: This set of APIs to manage whitelisting numbers on Airtel IoT portal in Batch
paths:
  /wt/numbers:
    get:
      tags:
      - Whitelisting
      summary: Fetch SMS Whitelisted Number
      description: Fetch SMS Whitelisted Number by msisdn, simNo,basketName,pageNo,pagesize
      operationId: fetchSMSWhitelistedNumbersUsingGET
      parameters:
      - name: Authorization
        in: header
        description: Authorization Header (Value must be like Bearer <Developer Access Token>)
        required: true
        schema:
          type: string
          default: Bearer XXXXXXXXXXXXXX
      - name: apikey
        in: header
        description: Developer API Key
        required: true
        schema:
          type: string
      - name: basketId
        in: query
        description: Basket ID
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
      - name: customer-id
        in: header
        description: 'Unique ID to identify Customer (shared during On-Boarding process) '
        required: true
        schema:
          type: integer
          format: int64
      - name: iv-user
        in: header
        description: Developer Account User ID
        required: true
        schema:
          type: string
      - name: msisdn
        in: query
        description: msisdn
        allowEmptyValue: false
        schema:
          type: string
      - name: pageNo
        in: query
        description: Page Number in case of pagination. Default Page No. is 1.
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
          default: 1
      - name: pageSize
        in: query
        description: Page Size in pagination. Default Page Size is 25 and Maximum is 100.
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
          default: 25
      - name: simNo
        in: query
        description: SIM Number
        allowEmptyValue: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SMSWTLResponse'
        '400':
          description: Request Message is not correct
          content: {}
        '500':
          description: Internal Server Error.
          content: {}
      deprecated: false
  /wt/numbers/batch:
    post:
      tags:
      - Whitelisting
      summary: SMS Batch Whitelisting API
      description: SMS batch whitelisting on Airtel IoT portal. Minimum 1 and Maximum 100 MSISDN can be whitelisted at once
      operationId: smsWhitelistedNumbersBatchUsingPOST
      parameters:
      - name: Authorization
        in: header
        description: Authorization Header (Value must be like Bearer <Developer Access Token>)
        required: true
        schema:
          type: string
          default: Bearer XXXXXXXXXXXXXX
      - name: apikey
        in: header
        description: Developer API Key
        required: true
        schema:
          type: string
      - name: customer-id
        in: header
        description: 'Unique ID to identify Customer (shared during On-Boarding process) '
        required: true
        schema:
          type: integer
          format: int64
      - name: iv-user
        in: header
        description: Developer Account User ID
        required: true
        schema:
          type: string
      requestBody:
        description: requestDO
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsWhitelistBatchDO'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobVO'
        '201':
          description: Resource Created Successfully
          content: {}
        '400':
          description: Request Message is not correct
          content: {}
        '500':
          description: Internal Server Error.
          content: {}
      deprecated: false
      x-codegen-request-body-name: requestDO
  /voice/numbers:
    get:
      tags:
      - Whitelisting
      summary: Fetch Voice Whitelist Numbers from CMP
      description: This API will fetch all numbers for Voice Whitelist on CMP portal with existing whitelisted records
      operationId: fetchVoiceWhitelistedNumbersUsingGET
      parameters:
      - name: Authorization
        in: header
        description: Authorization Header (Value must be like Bearer <Developer Access Token>)
        required: true
        schema:
          type: string
          default: Bearer XXXXXXXXXXXXXX
      - name: apikey
        in: header
        description: Developer API Key
        required: true
        schema:
          type: string
      - name: customer-id
        in: header
        description: 'Unique ID to identify Customer (shared during On-Boarding process) '
        required: true
        schema:
          type: integer
          format: int64
      - name: iv-user
        in: header
        description: Developer Account User ID
        required: true
        schema:
          type: string
      - name: msisdn
        in: query
        description: msisdn
        allowEmptyValue: false
        schema:
          type: string
      - name: pageNo
        in: query
        description: Page Number in case of pagination. Default Page No. is 1.
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
          default: 1
      - name: pageSize
        in: query
        description: Page Size in pagination. Default Page Size is 25 and Maximum is 100.
        allowEmptyValue: false
        schema:
          type: integer
          format: int32
          default: 25
      - name: simNo
        in: query
        description: SIM Number
        allowEmptyValue: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhitelistResponse'
        '400':
          description: Request Message is not correct
          content: {}
        '500':
          description: Internal Server Error.
          content: {}
      deprecated: false
components:
  schemas:
    SmsWhitelistBatchDO:
      title: SmsWhitelistBatchDO
      type: object
      properties:
        simWTDoList:
          type: array
          items:
            $ref: '#/components/schemas/SmsWhitelistNoDO'
    WhitelistResponse:
      title: WhitelistResponse
      type: object
      properties:
        total:
          type: integer
          format: int32
        whitelistDetails:
          type: array
          items:
            $ref: '#/components/schemas/WhitelistVO'
    SMSWTLResponse:
      title: SMSWTLResponse
      type: object
      properties:
        smsWTDetailsVO:
          type: array
          items:
            $ref: '#/components/schemas/SMSWTLDetailsVO'
        total:
          type: integer
          format: int32
    JobVO:
      title: JobVO
      type: object
      properties:
        errorFileName:
          type: string
          description: Error File Name
        errorItemsCount:
          type: integer
          description: Count of Error items in uploaded file.
          format: int32
        failureCount:
          type: integer
          description: Failure Order Count
          format: int32
        inProgressCount:
          type: integer
          description: In Progress Order Count
          format: int32
        jobId:
          type: integer
          description: Job ID, in case a particular Job ID to be fetched
          format: int64
        jobType:
          type: string
          description: Job Type as defined in CMP
        orderCompletionTime:
          type: string
          description: End Date in a date range to fetch Job IDs
        orderCount:
          type: integer
          description: Order Count
          format: int32
        orderInitiateDate:
          type: string
          description: Start Date in a date range to fetch Job IDs
        rejectedCount:
          type: integer
          description: Rejected Order Count
          format: int32
        requestedOrderItems:
          type: integer
          description: Count of items requested in uploaded file.
          format: int32
        statusCode:
          type: string
          description: Job Status Code
        statusMessage:
          type: string
          description: Status of Job IDs
        successCount:
          type: integer
          description: Success Order Count
          format: int32
        uploadFileName:
          type: string
          description: Upload File Name
    SMSWTLDetailsVO:
      title: SMSWTLDetailsVO
      type: object
      properties:
        basketName:
          type: string
        msisdn:
          type: string
        remainingOrderCount:
          type: string
        simNo:
          type: string
        whitelistNumber1:
          type: string
        whitelistNumber2:
          type: string
        whitelistNumber3:
          type: string
        whitelistNumber4:
          type: string
        whitelistType1:
          type: string
        whitelistType2:
          type: string
        whitelistType3:
          type: string
        whitelistType4:
          type: string
    WhitelistVO:
      title: WhitelistVO
      type: object
      properties:
        basketName:
          type: string
        msisdn:
          type: string
        remainingOrderCount:
          type: integer
          format: int32
        simNo:
          type: string
        voiceWhitelisted:
          type: string
        whitelistNumber1:
          type: string
        whitelistNumber2:
          type: string
        whitelistNumber3:
          type: string
        whitelistNumber4:
          type: string
        whitelistType1:
          type: string
        whitelistType2:
          type: string
        whitelistType3:
          type: string
        whitelistType4:
          type: string
    SmsWhitelistNoDO:
      title: SmsWhitelistNoDO
      required:
      - msisdn
      type: object
      properties:
        msisdn:
          type: string
          description: Mobile No.
        whitelistNumber1:
          type: string
          description: First number for whitelist
        whitelistNumber2:
          type: string
          description: Second number for whitelist
        whitelistNumber3:
          type: string
          description: Third number for whitelist
        whitelistNumber4:
          type: string
          description: Fourth number for whitelist
        whitelistNumberType1:
          type: string
          example: INCOMING
          enum:
          - ${SmsWhitelistNoDO.SMSWtlTypes.allowableValues}
        whitelistNumberType2:
          type: string
          example: INCOMING
          enum:
          - ${SmsWhitelistNoDO.SMSWtlTypes.allowableValues}
        whitelistNumberType3:
          type: string
          example: OUTGOING
          enum:
          - ${SmsWhitelistNoDO.SMSWtlTypes.allowableValues}
        whitelistNumberType4:
          type: string
          example: OUTGOING
          enum:
          - ${SmsWhitelistNoDO.SMSWtlTypes.allowableValues}
x-tagGroups:
- name: Manage Customer APIs
  tags:
  - Account Authorization
  - Account Details
  - Inventory Management
- name: New Orders APIs
  tags:
  - SIM LifeCycle
- name: Bulk Orders APIs
  tags:
  - SIM LifeCycle Bulk
- name: Jobs APIs
  tags:
  - Job Status
- name: Device Details APIs
  tags:
  - Device & Session Information
- name: Whitelisting APIs
  tags:
  - Whitelisting
- name: KYC APIs
  tags:
  - KYC Manager
- name: Messaging Centre APIs
  tags:
  - Messaging Centre