# seven.io SMS API

**Provider:** seven.io
**Category:** communication
**Base URL:** `https://gateway.seven.io/api`
**Auth:** api-key — `X-Api-Key: YOUR_API_KEY`
**Rate Limit:** See documentation
**Free Tier:** No
**Pricing:** Enterprise / contact sales (pay-as-you-go)
**Docs:** https://help.seven.io/en/api-docs

## Description

SMS gateway API for sending text messages worldwide, checking account balances, managing contacts, validating phone numbers, and setting up webhooks.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://gateway.seven.io/api/sms` | Send an SMS |
| GET | `https://gateway.seven.io/api/balance` | Get account balance |
| GET | `https://gateway.seven.io/api/contacts` | List contacts |
| POST | `https://gateway.seven.io/api/contacts` | Create a contact |
| POST | `https://gateway.seven.io/api/lookup` | Phone number lookup |
| GET | `https://gateway.seven.io/api/hooks` | List webhooks |
| POST | `https://gateway.seven.io/api/hooks` | Create a webhook |
| GET | `https://gateway.seven.io/api/analytics` | Get usage analytics |

## Authentication

API key in the X-Api-Key header

```
X-Api-Key: YOUR_API_KEY
```

## Sample Request

```bash
curl -X POST 'https://gateway.seven.io/api/sms' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d 'to=+1234567890&text=Hello+World&from=MyApp'
```

## Sample Response

```json
{"success":"100","total_price":0.049,"messages":[{"id":"abc123","status":"100","recipient":"+1234567890"}]}
```

## Pricing Details

Pay-per-message pricing; free credits on signup.

---

*Source: [API Map](https://apimap.dev/apis/sms77/) — CC BY 4.0*