Bharti Airtel

Bharti Airtel Limited is an Indian multinational telecommunications operator headquartered in New Delhi, and one of the two dominant mobile network operators in its home market of India alongside Reliance Jio. It runs mobile (2G/4G/5G), fixed broadband, DTH television, enterprise connectivity, data centre (Nxtra) and payments-bank businesses across India, South Asia and — through the separately listed Airtel Africa — fourteen African countries. In the telecom value chain Airtel is an access-network owner: it holds the spectrum, the SIM estate, the subscriber identity and the network signalling that the rest of the industry resells. Its API posture is split in two, and the split is the whole story. The connectivity-product side is genuinely API-native and publicly documented: Airtel IQ, the operator's CPaaS suite, publishes open Swagger for its SMS and CDR reporting APIs and offers a self-serve trial account, while the Airtel IoT and Airtel Locate developer portals publish complete OpenAPI 3.0 catalogues (43 and 19 operations) as Redoc pages that need no login. The network-API side — the CAMARA and GSMA Open Gateway surface that defines this sector — is the opposite: Airtel is a GSMA Open Gateway signatory, a founding operator shareholder in Aduna (the Ericsson-led network-API joint venture), and has commercially launched a CAMARA SIM Swap API to Indian banks through a federated Jio/Vi/Airtel channel, yet it publishes no CAMARA endpoint, no CAMARA specification, no CIBA authorization surface and no network-API developer portal of its own. Developers reach Airtel's network capabilities only through aggregators — Aduna, and Nokia's Network as Code platform — never directly. Its own "Airtel API Marketplace" at developers.airtel.in is a login wall, and its original 2017 Smart API partner programme at openapi.airtel.in/smartapi survives as an unmaintained legacy portal.

Bharti Airtel publishes 4 APIs on the APIs.io network, including Airtel IQ SMS API, Airtel IQ Reporting API, Airtel IoT API, and 1 more. Tagged areas include Telecommunications, India, Mobile Network Operator, Network APIs, and CAMARA.

The Bharti Airtel catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Bharti Airtel’s developer surface includes authentication, sandbox, documentation, API reference, getting-started guide, signup flow, developer console, and 30 more developer resources.

🌐 Visit website 📡 Source on GitHub
47.2/100 developing ▬ flat Agent 75/100 agent native Full breakdown ↓
scored 2026-07-28 · rubric v0.5
5 APIs 1 MCP Servers
TelecommunicationsIndiaMobile Network OperatorNetwork APIsCAMARAOpen GatewaySIM SwapCPaaSMessagingSMSRCSVoiceIoTM2MDevice LocationBroadband5GIdentity VerificationCarrier BillingConsent Management

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.5
Composite quality — 47.2/100 · developing
Contract Quality 13.7 / 25
Developer Ergonomics 14.8 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 1.0 / 13
Governance 0.0 / 12
Discoverability 8.8 / 10
Agent readiness — 75/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/bharti-airtel: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Airtel IQ SMS API

The messaging half of Airtel IQ, Airtel's network-embedded CPaaS suite. Sends single, bulk, CSV-batch and content-moderated A2P SMS over Airtel's pan-India network, with TRAI DL...

Airtel IQ Reporting API

The Call Detail Record (CDR) reporting surface of Airtel IQ. Returns detailed per-call records — time, date, duration, caller ID, destination number, status and call-recording U...

Airtel IoT API

Airtel's IoT/M2M connectivity-management API, published as a complete OpenAPI 3.0.1 catalogue of 43 operations across ten areas: account authorization, account details, inventor...

Airtel Locate API

Airtel Locate is the operator's network-based device-location platform, letting enterprises track a device by MSISDN without relying on the device's GPS. Published as an OpenAPI...

Airtel Smart API (legacy)

Airtel's original partner developer programme, launched in 2017 and now an unmaintained legacy portal (the site still carries a 2017 copyright). Its public documentation still d...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

bharti-airtel-mcp.yml

MCP SERVER

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Bharti Airtel Webhooks

ASYNCAPI

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Bharti Airtel Authentication

http-basic/oauth2 · 4 schemes

SECURITY

Bharti Airtel Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Bharti Airtel Vulnerability Disclosure

Hackerone · security.txt

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Bharti Airtel Scopes

4 scopes · clientCredentials/authorizationCode/implicit

4 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Bharti Airtel Agentic Access

68 operations · 35 acting

68 operations · 35 acting

AGENTIC

Resources

Get Started 5

Portal, sign-up, and the first successful call

Sandbox
Sandbox
 GettingStarted
GettingStarted
 DeveloperPortal
DeveloperPortal
 SignUp
SignUp
 Console
Console

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 9

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 MCPServer
MCPServer
 WellKnown
WellKnown
 LLMsTxt
LLMsTxt
 LLMsTxt
LLMsTxt
 AgentSkill
AgentSkill
 AgentSkill
AgentSkill
 AgentSkill
AgentSkill
 AgentSkill
AgentSkill

Scroll for all 9

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Conformance
Conformance
 DataModel
DataModel
 Webhooks
Webhooks

Build 1

SDKs, sample code, and the tooling you integrate with

Packages
Packages

Access & Security 4

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 VulnerabilityDisclosure
VulnerabilityDisclosure
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Learn 1

Tutorials, courses, talks, and written guidance

YouTube
YouTube

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 PrivacyPolicy
PrivacyPolicy
 TermsOfService
TermsOfService

Company 4

The organization behind the API

Website
Website
 Blog
Blog
 LinkedIn
LinkedIn
 Twitter
Twitter

Other 1

Properties that don't map to a standard resource type

Email
Email

Source (apis.yml)

apis.yml Raw ↑ 
aid: bharti-airtel
url: https://raw.githubusercontent.com/api-evangelist/bharti-airtel/refs/heads/main/apis.yml
name: Bharti Airtel
kind: company
description: 'Bharti Airtel Limited is an Indian multinational telecommunications operator headquartered in New Delhi, and
  one of the two dominant mobile network operators in its home market of India alongside Reliance Jio. It runs mobile (2G/4G/5G),
  fixed broadband, DTH television, enterprise connectivity, data centre (Nxtra) and payments-bank businesses across India,
  South Asia and — through the separately listed Airtel Africa — fourteen African countries. In the telecom value chain Airtel
  is an access-network owner: it holds the spectrum, the SIM estate, the subscriber identity and the network signalling that
  the rest of the industry resells. Its API posture is split in two, and the split is the whole story. The connectivity-product
  side is genuinely API-native and publicly documented: Airtel IQ, the operator''s CPaaS suite, publishes open Swagger for
  its SMS and CDR reporting APIs and offers a self-serve trial account, while the Airtel IoT and Airtel Locate developer portals
  publish complete OpenAPI 3.0 catalogues (43 and 19 operations) as Redoc pages that need no login. The network-API side —
  the CAMARA and GSMA Open Gateway surface that defines this sector — is the opposite: Airtel is a GSMA Open Gateway signatory,
  a founding operator shareholder in Aduna (the Ericsson-led network-API joint venture), and has commercially launched a CAMARA
  SIM Swap API to Indian banks through a federated Jio/Vi/Airtel channel, yet it publishes no CAMARA endpoint, no CAMARA specification,
  no CIBA authorization surface and no network-API developer portal of its own. Developers reach Airtel''s network capabilities
  only through aggregators — Aduna, and Nokia''s Network as Code platform — never directly. Its own "Airtel API Marketplace"
  at developers.airtel.in is a login wall, and its original 2017 Smart API partner programme at openapi.airtel.in/smartapi
  survives as an unmaintained legacy portal.'
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Telecommunications
- India
- Mobile Network Operator
- Network APIs
- CAMARA
- Open Gateway
- SIM Swap
- CPaaS
- Messaging
- SMS
- RCS
- Voice
- IoT
- M2M
- Device Location
- Broadband
- 5G
- Identity Verification
- Carrier Billing
- Consent Management
created: '2026-07-25'
modified: '2026-07-25'
specificationVersion: '0.19'
apis:
- aid: bharti-airtel:airtel-iq-sms-api
  name: Airtel IQ SMS API
  description: The messaging half of Airtel IQ, Airtel's network-embedded CPaaS suite. Sends single, bulk, CSV-batch and content-moderated
    A2P SMS over Airtel's pan-India network, with TRAI DLT (Hyperledger-based distributed ledger) scrubbing for sender header,
    content template and consent compliance applied in-path. Authenticated with HTTP Basic using API-key credentials issued
    from the Airtel IQ dashboard. Swagger 2.0 published openly at openapi.airtel.in.
  humanURL: https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/sms-utility
  baseURL: https://iqsms.airtel.in/api/v1
  tags:
  - Messaging
  - SMS
  - CPaaS
  - India
  properties:
  - type: Documentation
    url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/overview
  - type: APIReference
    url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/sms-utility
  - type: OpenAPI
    url: openapi/bharti-airtel-iq-sms-openapi.yml
  - type: Overlay
    url: overlays/bharti-airtel-iq-sms-overlay.yaml
  - type: SignUp
    url: https://www.airtel.in/business/b2b/airtel-ccp/dashboard/#/signup
- aid: bharti-airtel:airtel-iq-reporting-api
  name: Airtel IQ Reporting API
  description: The Call Detail Record (CDR) reporting surface of Airtel IQ. Returns detailed per-call records — time, date,
    duration, caller ID, destination number, status and call-recording URL — for voice traffic placed through Airtel IQ Intelliphones
    and call flows. Swagger 2.0 published openly at openapi.airtel.in.
  humanURL: https://www.airtel.in/business/b2b/airtel-iq/api-docs/voice/sample-cdr
  baseURL: https://openapi.airtel.in/gateway/airtel-xchange-reporting/v2
  tags:
  - Voice
  - Reporting
  - CDR
  - CPaaS
  properties:
  - type: Documentation
    url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/voice/overview
  - type: APIReference
    url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/voice/sample-cdr
  - type: OpenAPI
    url: openapi/bharti-airtel-iq-reporting-openapi.yml
  - type: Overlay
    url: overlays/bharti-airtel-iq-reporting-overlay.yaml
- aid: bharti-airtel:airtel-iot-api
  name: Airtel IoT API
  description: 'Airtel''s IoT/M2M connectivity-management API, published as a complete OpenAPI 3.0.1 catalogue of 43 operations
    across ten areas: account authorization, account details, inventory management, SIM lifecycle (activate, swap, change
    plan, safe custody, temporary disconnection), bulk SIM lifecycle, job status, device and session information, SMS and
    voice whitelisting, KYC management, and a messaging centre. Authenticated with OAuth 2.0 client-credentials against /auth/v2/generate/authtoken
    with refresh-token support. Documented publicly with Redoc, no login required.'
  humanURL: https://www.airtel.in/m2m/business/b2b/m2m-solutions/documentation/m2m-solutions/
  baseURL: https://m2m.airteliot.co.in/iot/api/
  tags:
  - IoT
  - M2M
  - SIM Management
  - Connectivity
  - eSIM
  - KYC
  properties:
  - type: Documentation
    url: https://www.airtel.in/m2m/business/b2b/m2m-solutions/documentation/m2m-solutions/
  - type: APIReference
    url: https://www.airtel.in/m2m/business/b2b/m2m-solutions/documentation/m2m-solutions/
  - type: OpenAPI
    url: openapi/bharti-airtel-iot-openapi.yml
  - type: Overlay
    url: overlays/bharti-airtel-iot-overlay.yaml
- aid: bharti-airtel:airtel-locate-api
  name: Airtel Locate API
  description: Airtel Locate is the operator's network-based device-location platform, letting enterprises track a device
    by MSISDN without relying on the device's GPS. Published as an OpenAPI 3.0.0 catalogue (version 1.4.8) of 19 operations
    across five areas — Authorization, Resource Consent, Location, Address Validation and Tenant management — with explicit
    subscriber consent capture and an asynchronous mode that posts location to a customer-registered callback listener. This
    is Airtel's proprietary location API, not the CAMARA Device Location or Location Verification API. Documented publicly
    with Redoc, no login required.
  humanURL: https://www.airtel.in/m2m/business/b2b/locate-solution/documentation/locate-solution/
  baseURL: https://openapi.airtel.in/locate/apis
  tags:
  - Device Location
  - Consent Management
  - IoT
  - Location
  - Address Validation
  properties:
  - type: Documentation
    url: https://www.airtel.in/m2m/business/b2b/locate-solution/documentation/locate-solution/
  - type: APIReference
    url: https://www.airtel.in/m2m/business/b2b/locate-solution/documentation/locate-solution/
  - type: OpenAPI
    url: openapi/bharti-airtel-locate-openapi.yml
  - type: Overlay
    url: overlays/bharti-airtel-locate-overlay.yaml
- aid: bharti-airtel:airtel-smart-api
  name: Airtel Smart API (legacy)
  description: Airtel's original partner developer programme, launched in 2017 and now an unmaintained legacy portal (the
    site still carries a 2017 copyright). Its public documentation still describes real OAuth 2.0 authorization-code and implicit
    grant flows and three partner services — carrier-billing charge, subscription activation/deactivation, and an LRN (local
    routing number) and porting lookup — plus an Aadhaar/UIDAI DigiAuth authentication and e-KYC integration. Production host
    is not published; documented endpoints use an <IP>:<Port> placeholder and access is granted only after partner registration,
    so no specification was harvestable.
  humanURL: https://openapi.airtel.in/smartapi/#/docs
  tags:
  - Carrier Billing
  - Subscriptions
  - Identity Verification
  - Legacy
  - OAuth
  properties:
  - type: Documentation
    url: https://openapi.airtel.in/smartapi/#/docs
  - type: APIReference
    url: https://openapi.airtel.in/smartapi/#/docs/subscriptions
  - type: Documentation
    url: https://openapi.airtel.in/smartapi/#/docs/payment
  - type: Documentation
    url: https://openapi.airtel.in/smartapi/#/docs/UIDAI
  - type: Documentation
    url: https://openapi.airtel.in/smartapi/#/docs/developerAuth
common:
- type: AgenticAccess
  url: agentic-access/bharti-airtel-agentic-access.yml
- type: DomainSecurity
  url: security/bharti-airtel-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/bharti-airtel-vulnerability-disclosure.yml
- type: Authentication
  url: authentication/bharti-airtel-authentication.yml
- type: OAuthScopes
  url: scopes/bharti-airtel-scopes.yml
- type: Conventions
  url: conventions/bharti-airtel-conventions.yml
- type: ErrorCatalog
  url: errors/bharti-airtel-problem-types.yml
- type: Lifecycle
  url: lifecycle/bharti-airtel-lifecycle.yml
- type: Conformance
  url: conformance/bharti-airtel-conformance.yml
- type: DataModel
  url: data-model/bharti-airtel-data-model.yml
- type: Sandbox
  url: sandbox/bharti-airtel-sandbox.yml
- type: Webhooks
  url: asyncapi/bharti-airtel-webhooks.yml
- type: MCPServer
  url: mcp/bharti-airtel-mcp.yml
- type: Packages
  url: packages/bharti-airtel-packages.yml
- type: WellKnown
  url: well-known/bharti-airtel-well-known.yml
- type: LLMsTxt
  url: llms/bharti-airtel-llms.txt
- type: LLMsTxt
  name: API-surface llms.txt (generated companion)
  url: llms/bharti-airtel-apis-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: AgentSkill
  name: Send a DLT-compliant SMS with Airtel IQ
  url: skills/bharti-airtel-send-compliant-sms.md
- type: AgentSkill
  name: Locate a device with subscriber consent using Airtel Locate
  url: skills/bharti-airtel-locate-device-with-consent.md
- type: AgentSkill
  name: Manage the Airtel IoT SIM lifecycle
  url: skills/bharti-airtel-manage-iot-sim-lifecycle.md
- type: Website
  url: https://www.airtel.in/
- type: Documentation
  url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/overview
- type: APIReference
  url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/sms/sms-utility
- type: GettingStarted
  url: https://www.airtel.in/business/b2b/airtel-iq/api-docs/voice/overview
- type: DeveloperPortal
  url: https://developers.airtel.in/
- type: SignUp
  url: https://www.airtel.in/business/b2b/airtel-ccp/dashboard/#/signup
- type: Console
  url: https://www.airtel.in/business/b2b/airtel-ccp/dashboard/
- type: Support
  url: https://www.airtel.in/contact-us
- type: Blog
  url: https://www.airtel.in/blog/
- type: Pricing
  url: https://www.airtel.in/business/b2b/cpaas
- type: PrivacyPolicy
  url: https://www.airtel.in/privacy-policy/
- type: TermsOfService
  url: https://www.airtel.in/mobile/terms-conditions
- type: LinkedIn
  url: https://www.linkedin.com/company/airtel-business/
- type: Twitter
  url: https://twitter.com/airtelindia/
- type: YouTube
  url: https://www.youtube.com/channel/UC62RQR1TkP_945zTN6Jwecg
- type: Email
  url: mailto:iqsalessupport@airtel.com
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com