aid: bandwidth

deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived

accessModel:
  pricing: paid
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Paid
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived

image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bandwidth.png

url: https://raw.githubusercontent.com/api-evangelist/bandwidth/refs/heads/main/apis.yml

name: Bandwidth

x-docs-platform: docusaurus

x-docs-platform-confidence: medium

x-docs-platform-checked: 2026-09-20

tags:
- Communications
- CPaaS
- Voice
- Messaging
- Telephony
- SMS
- MFA
- Telecommunications

modified: '2026-05-19'

description: Bandwidth is a leading cloud-based communications platform providing voice, messaging, emergency calling, phone number management,
  multi-factor authentication, and toll-free verification APIs. Built on Bandwidth's own Tier 1 network, the platform delivers enterprise-grade
  reliability for CPaaS applications.

created: '2024-01-01'

maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

specificationVersion: '0.23'

common:
- type: FinOps
  url: finops/bandwidth-finops.yml
- type: RateLimits
  url: rate-limits/bandwidth-rate-limits.yml
- type: Plans
  url: plans/bandwidth-plans-pricing.yml
- type: Spectral
  url: rules/bandwidth-spectral-rules.yml
- type: Spectral
  url: rules/bandwidth-rules.yml
- type: Spectral
  url: rules/bandwidth-jsonschema-spectral-rules.yml
- type: Spectral
  url: rules/bandwidth-asyncapi-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/bandwidth-vocabulary.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Webhooks
  url: asyncapi/bandwidth-webhooks.yml
- type: DataModel
  url: data-model/bandwidth-data-model.yml
- type: Compliance
  url: https://www.bandwidth.com/security/
- type: ErrorCatalog
  url: errors/bandwidth-problem-types.yml
- type: Conformance
  url: conformance/bandwidth-conformance.yml
- type: LLMsTxt
  url: llms/bandwidth-llms.txt
- type: SecurityTxt
  url: well-known/bandwidth-status-security.txt
- type: SecurityTxt
  url: well-known/bandwidth-community-security.txt
- type: WellKnown
  url: well-known/bandwidth-well-known.yml
- type: Hosts
  url: hosts/bandwidth-hosts.yml
- type: Vendors
  url: vendors/bandwidth-vendors.yml
- type: SDKs
  url: packages/bandwidth-packages.yml
- type: Packages
  url: packages/bandwidth-packages.yml
- type: Webhooks
  url: https://www.bandwidth.com/glossary/webhook/
- type: Security
  url: https://www.bandwidth.com/security/
- type: Pricing
  url: https://www.bandwidth.com/pricing/
- type: Newsroom
  url: https://www.bandwidth.com/newsroom/
- type: Login
  url: https://community.bandwidth.com/login
- type: Leadership
  url: https://www.bandwidth.com/leadership/
- type: ChangeLog
  url: https://www.bandwidth.com/release-notes/
- type: GettingStarted
  url: https://dev.bandwidth.com/docs/voice/programmable-voice/build-free-trial
- type: CapabilityMap
  url: capabilities/bandwidth-capability-edges.yml
  name: Bandwidth Business Capability Map
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/bandwidth/overview
- type: AgenticAccess
  url: agentic-access/bandwidth-agentic-access.yml
- type: TrustCenter
  url: security/bandwidth-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/bandwidth-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/bandwidth-domain-security.yml
- type: Authentication
  url: authentication/bandwidth-authentication.yml
- type: GitHubOrganization
  url: https://github.com/Bandwidth
- type: LinkedIn
  url: https://www.linkedin.com/company/bandwidth-inc
- type: Website
  url: https://www.bandwidth.com/
  name: Bandwidth
- type: Documentation
  url: https://dev.bandwidth.com/
  name: Bandwidth Developer Portal
- type: Signup
  url: https://app.bandwidth.com/signup
  name: Sign Up for Bandwidth
- type: Blog
  url: https://www.bandwidth.com/blog/
  name: Bandwidth Blog
- type: TermsOfService
  url: https://www.bandwidth.com/legal/
  name: Terms of Service
- type: PrivacyPolicy
  url: https://www.bandwidth.com/legal/privacy-policy/
  name: Privacy Policy
- type: StatusPage
  url: https://status.bandwidth.com/
  name: Bandwidth System Status
- type: Support
  url: https://support.bandwidth.com/
  name: Bandwidth Support
- type: SpectralRules
  url: rules/bandwidth-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/bandwidth-vocabulary.yaml
- type: JSONSchema
  url: json-schema/bandwidth-call-schema.json
- type: JSONSchema
  url: json-schema/bandwidth-message-schema.json
- type: JSONSchema
  url: json-schema/bandwidth-phone-number-schema.json
- type: JSONLD
  url: json-ld/bandwidth-context.jsonld
- name: Features
  type: Features
  data:
  - 'SMS 10DLC outbound: $0.004/message'
  - 'MMS 10DLC outbound: $0.015/message'
  - 'SMS Short Code: $0.008/msg out, MMS Short Code: $0.020'
  - 'SMS Toll-free: $0.007/msg out'
  - 'Voice US Local: $0.010 outbound, $0.0055 inbound per minute'
  - Tier 1 carrier with own network and interconnects
  - REST API for Messaging and Voice
  - Default 10 messages/sec and 10 calls/sec
  - OAuth + API keys
  - Webhooks for delivery receipts and inbound events
  - BXML for voice IVR scripting
  - Verify API for OTP
  - Number Management API
  - Phone Number Insight (line-type lookup)
  - Iris API for porting and management
  - Enterprise committed-use volume contracts
  sources:
  - https://www.bandwidth.com/pricing/
  updated: '2026-05-04'
- name: Use Cases
  type: UseCases
  data:
  - name: Click-to-Call
    description: Embed outbound calling in web and mobile applications.
  - name: IVR Systems
    description: Build interactive voice response menus with DTMF input and TTS.
  - name: A2P Messaging
    description: Send application-to-person SMS campaigns at scale.
  - name: 2FA / OTP
    description: Add SMS or voice-based multi-factor authentication to applications.
  - name: Number Provisioning
    description: Automate phone number procurement and assignment for customers.
  - name: E911 Compliance
    description: Meet Kari's Law and RAY BAUM's Act requirements for enterprise voice.
  - name: Call Center
    description: Build inbound/outbound contact center applications with recording.
  - name: Number Porting
    description: Migrate existing phone numbers to Bandwidth programmatically.
- name: Integrations
  type: Integrations
  data:
  - name: Cisco Webex
  - name: Microsoft Teams
  - name: Zoom Phone
  - name: Twilio
  - name: Salesforce
  - name: Amazon Connect
  - name: Genesys Cloud
- type: Integrations
  url: https://www.bandwidth.com/integrations/
- type: LlmsText
  url: https://dev.bandwidth.com/llms.txt

apis:
- aid: bandwidth:bandwidth-calls-api
  name: Bandwidth Calls API
  description: Create, retrieve, and manage phone calls. Supports outbound call creation, call state queries, and in-progress call modifications
    using BXML or redirect URLs.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Calls
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-calls-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-create-call-request-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-call-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-update-call-request-schema.json
- aid: bandwidth:bandwidth-conferences-api
  name: Bandwidth Conferences API
  description: Create and manage multi-party conference calls. Supports adding and removing members, muting, holding, and playing audio to conferences.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Conferences
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-conferences-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-recording-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-conference-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-update-conference-request-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-update-conference-member-request-schema.json
- aid: bandwidth:bandwidth-emergency-notification-recipients-api
  name: Bandwidth Emergency Notification Recipients API
  description: Configure notification recipients who receive alerts when 911 calls are made from your endpoints.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Emergency Notification Recipients
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-emergency-notification-recipients-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-notification-recipient-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-notification-recipient-list-response-schema.json
- aid: bandwidth:bandwidth-endpoints-api
  name: Bandwidth Endpoints API
  description: Manage 911 endpoints that represent end users of your service. Endpoints are identified by Alternate End User IDs (AEUIs) and are
    associated with locations for emergency routing.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags: []
  tags_raw:
  - Endpoints
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-endpoints-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-endpoint-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-endpoint-list-response-schema.json
- aid: bandwidth:bandwidth-locations-api
  name: Bandwidth Locations API
  description: Provision and manage physical locations (addresses) for 911 emergency services routing. Locations are validated against the Master
    Street Address Guide (MSAG) for accuracy.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Location
  tags_raw:
  - Locations
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-locations-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-location-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-location-list-response-schema.json
- aid: bandwidth:bandwidth-media-api
  name: Bandwidth Media API
  description: Upload, retrieve, and manage media files for use in MMS messages. Supports files up to 3.75 MB with 48-hour retention.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-media-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-media-schema.json
- aid: bandwidth:bandwidth-messages-api
  name: Bandwidth Messages API
  description: Send and retrieve SMS and MMS messages. Supports single and group messaging, delivery receipts, and message history queries.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Message
  tags_raw:
  - Messages
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-messages-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-create-message-request-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-message-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-message-list-schema.json
- aid: bandwidth:bandwidth-recordings-api
  name: Bandwidth Recordings API
  description: Manage call recordings including retrieval of recording metadata, audio files, and transcription of recorded audio content.
  humanURL: https://dev.bandwidth.com/docs/voice/
  baseURL: https://voice.bandwidth.com/api/v2
  tags:
  - Recording
  tags_raw:
  - Recordings
  properties:
  - type: OpenAPI
    url: openapi/bandwidth-recordings-api-openapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/voice/
  - type: AsyncAPI
    url: asyncapi/bandwidth-voice-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/messaging/
  - type: AsyncAPI
    url: asyncapi/bandwidth-messaging-events-asyncapi.yml
  - type: Documentation
    url: https://dev.bandwidth.com/docs/emergency/emergencyCallingApi/
  - type: JSONSchema
    url: json-schema/bandwidth-recording-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-transcription-schema.json
  - type: JSONSchema
    url: json-schema/bandwidth-transcription-request-schema.json

integrations:
- name: Microsoft Teams
- name: Operator Connect
- name: Genesys Cloud CX
- name: Webex Calling
- name: Zoom Phone
- name: Google Voice SIP Link
- name: Five9
- name: Pindrop
x-enrichment:
  date: '2026-10-04'
  status: enriched
  artifacts_added: 42
  pass: modular-v1
  engine: identity=local,contract=local,surfaces=local,docs=local,regulatory=local