# The SMS Works API

**Provider:** The SMS Works
**Category:** communication
**Base URL:** `https://api.thesmsworks.co.uk/v1`
**Auth:** api-key — `Authorization: YOUR_API_KEY`
**Rate Limit:** Not officially published
**Free Tier:** No
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://api.thesmsworks.co.uk/v1

## Description

The SMS Works provides a low-cost, reliable SMS API for developers. Pay only for delivered texts, all failed messages are refunded.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.thesmsworks.co.uk/v1/batch/any` | Sends a collection of unique SMS messages. Batches may contain up to 5000 messag |
| POST | `https://api.thesmsworks.co.uk/v1/batch/schedule` | Schedules a batch of SMS messages to be sent at the date time you specify |
| POST | `https://api.thesmsworks.co.uk/v1/batch/send` | Send a single SMS message to multiple recipients.  Batches may contain up to 500 |
| GET | `https://api.thesmsworks.co.uk/v1/batch/{batchid}` | Retrieve all messages in a batch with the given batch ID |
| DELETE | `https://api.thesmsworks.co.uk/v1/batches/schedule/{batchid}` | Cancels a scheduled SMS message |
| GET | `https://api.thesmsworks.co.uk/v1/credits/balance` | Returns the number of credits currently available on the account |
| POST | `https://api.thesmsworks.co.uk/v1/message/flash` | Sends an SMS flash message, which appears on the recipients lock screen |
| POST | `https://api.thesmsworks.co.uk/v1/message/schedule` | Schedules an SMS message to be sent at the date-time you specify |

## Authentication

API key in the request header (Authorization)

```
Authorization: YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://api.thesmsworks.co.uk/v1/batch/any' \
  -H 'Authorization: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Pay-as-you-go UK SMS. From £0.035/message. No monthly fees.

---

*Source: [API Map](https://apimap.dev/apis/the-sms-works/) — CC BY 4.0*