Vonage

Vonage SMS API

Send and receive SMS messages

GitHub OpenAPI

Operations 1

POST /sms/json Send an SMS Message #

Documentation

📖
Documentation
https://developer.vonage.com/en/api/sms
📖
Documentation
https://developer.vonage.com/en/api/voice
📖
Documentation
https://developer.vonage.com/en/api/messages-olympus
📖
Documentation
https://developer.vonage.com/en/api/verify
📖
Documentation
https://developer.vonage.com/en/api/numbers
📖
Documentation
https://developer.vonage.com/en/api/application.v2

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/openapi/vonage-sms-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/asyncapi/vonage-asyncapi.yml

Other Resources

🔗
BaseURL
https://rest.nexmo.com
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/graphql/vonage-graphql.md
🔗
BaseURL
https://api.nexmo.com/v1
🔗
BaseURL
https://api.nexmo.com/v1/messages
🔗
BaseURL
https://api.nexmo.com
🔗
BaseURL
https://api.nexmo.com/v2/applications

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/vonage-sms-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

vonage-sms-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Vonage Communications Applications SMS API
  description: Vonage provides cloud communications APIs for voice, SMS, messaging, video, and verification. The Vonage API platform enables businesses to build communication features into applications including voice calls, SMS, video conferencing, two-factor authentication, and number management.
  version: 1.0.0
  contact:
    name: Vonage Developer Support
    url: https://api.support.vonage.com/hc/en-us
  termsOfService: https://www.vonage.com/legal/
servers:
- url: https://api.nexmo.com
  description: Vonage API Main Server
- url: https://rest.nexmo.com
  description: Vonage REST API Server
security:
- basicAuth: []
- bearerAuth: []
tags:
- name: SMS
  description: Send and receive SMS messages
paths:
  /sms/json:
    post:
      operationId: sendSms
      summary: Send an SMS Message
      description: Send an outbound SMS from your Vonage number.
      tags:
      - SMS
      servers:
      - url: https://rest.nexmo.com
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - api_key
              - api_secret
              - to
              - from
              - text
              properties:
                api_key:
                  type: string
                  description: Your Vonage API key.
                api_secret:
                  type: string
                  description: Your Vonage API secret.
                to:
                  type: string
                  description: The phone number to send the message to (E.164 format).
                from:
                  type: string
                  description: The sender phone number or name.
                text:
                  type: string
                  description: The body of the SMS message.
                type:
                  type: string
                  enum:
                  - text
                  - binary
                  - unicode
                  description: The format of the message body.
                  default: text
      responses:
        '200':
          description: SMS sent successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsResponse'
components:
  schemas:
    SmsResponse:
      type: object
      properties:
        message-count:
          type: string
          description: Number of message parts sent.
        messages:
          type: array
          items:
            type: object
            properties:
              to:
                type: string
              message-id:
                type: string
              status:
                type: string
              remaining-balance:
                type: string
              message-price:
                type: string
              network:
                type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Base64-encoded API key and secret joined by a colon.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token for application-level authentication.