> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar SMS

> POST https://api.sms.json.pe/send: cuerpo JSON number y message, Authorization Bearer; respuesta success, message y message_id.

El envío real lo realiza el **teléfono Android** del cliente con la [app de Play Store](https://play.google.com/store/apps/details?id=com.leroik.sms); el dispositivo debe tener **saldo o condiciones de operadora** válidas para SMS. Consulta la **[Introducción](/api-sms/introduccion)** para el contexto completo.


## OpenAPI

````yaml api-sms/openapi.json POST /send
openapi: 3.0.1
info:
  title: json.pe - API SMS
  description: >-
    Envío de SMS usando el **celular Android del cliente** como origen. Producto
    de [json.pe](https://json.pe). Requiere la [app en Play
    Store](https://play.google.com/store/apps/details?id=com.leroik.sms),
    dispositivo **Android** y **saldo/plan de operadora** para SMS.
    [Introducción](https://docs.json.pe/api-sms/introduccion).
  version: 1.0.0
servers:
  - url: https://api.sms.json.pe
    description: API SMS json.pe
security:
  - bearerAuth: []
tags:
  - name: SMS
    description: Envío de mensajes SMS
paths:
  /send:
    post:
      tags:
        - SMS
      summary: Enviar SMS
      description: >-
        Solicita el envío de un **SMS** al número indicado. Cuerpo JSON con
        `number` y `message`. Headers: `Authorization: Bearer TU_TOKEN` y
        `Content-Type: application/json`. El mensaje sale por el **dispositivo
        Android** vinculado con saldo/plan de **operadora**.
      operationId: smsSend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sms-send-request'
      responses:
        '200':
          description: >-
            Envío aceptado o procesado. En éxito incluye `message_id` para
            referenciar el SMS.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sms-api-ok-response'
              example:
                success: true
                message: exito
                message_id: ABCDFESD
        '400':
          description: Solicitud inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
        '401':
          description: Token inválido o ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
components:
  schemas:
    sms-send-request:
      type: object
      required:
        - number
        - message
      properties:
        number:
          type: string
          description: >-
            Número de teléfono destino, con código de país, **sin** el símbolo +
            (ej. Perú: `51999999997`).
          example: '51999999997'
        message:
          type: string
          description: Texto del SMS a enviar.
          example: Hola, este es un mensaje de prueba.
      example:
        number: '51999999997'
        message: Hola, este es un mensaje de prueba.
    sms-api-ok-response:
      type: object
      required:
        - success
        - message
        - message_id
      properties:
        success:
          type: boolean
          description: Indica si la operación fue exitosa.
          example: true
        message:
          type: string
          description: Mensaje corto de estado (ej. `exito`).
          example: exito
        message_id:
          type: string
          description: >-
            Identificador del envío devuelto por el servicio (útil para
            trazabilidad o soporte).
          example: ABCDFESD
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: >-
        Token Bearer del panel json.pe (no compartas tokens en repositorios
        públicos).
      x-default: ''

````