# Rayo SMS API

> Official API Documentation and OpenAPI 3.1.0 specification for Rayo SMS (https://www.rayo.gr).

## Machine-Readable OpenAPI Specifications (for IDEs, SDK Generators & AI Agents)

- [OpenAPI 3.1.0 YAML](https://sms-api-docs.rayo.gr/openapi.yaml)
- [OpenAPI 3.1.0 JSON](https://sms-api-docs.rayo.gr/openapi.json)
- [Well-Known OpenAPI YAML](https://sms-api-docs.rayo.gr/.well-known/openapi.yaml)
- [Well-Known OpenAPI JSON](https://sms-api-docs.rayo.gr/.well-known/openapi.json)

## Base Endpoint & Authentication

- **Base URL**: `https://sms-api.rayo.gr`
- **Authentication**: HTTP Header `Authorization: ******
- **Webhook Signature Header**: `Rayo-SMS-Signature` (HMAC-SHA256 hex digest)
- **Web Application**: https://sms.rayo.gr

## API Endpoints

- `POST /v1/send_sms`: Sending an SMS (`sendSms`)
- `GET /v1/balance_in_credits`: Get Balance in Credits (`getBalanceInCredits`)
- `GET /v1/check_status`: Check Status of Sms Request (`checkSmsRequestStatus`)
- `DELETE /v1/sms_request_schedules/{id}`: Deleting a schedule (`deleteSmsRequestSchedule`)

## Webhooks

- `GET deliveryStatusUpdate`: Delivery Updates via a Callback Webhook (GET)
- `POST deliveryStatusUpdate`: Delivery Updates via a Callback Webhook (POST)