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

# API Reference

> Complete reference for the Phonovation REST API.

<Info>
  Phonovation was previously called InteractSMS. The current platform is listed as **InteractSMS 1.5** in the version selector, and its API URLs continue to use `interactsms.com` hostnames.
</Info>

## Base URL

All API requests are made to:

```text title="Base URL" icon=link wrap theme={"dark"}
https://api.interactsms.com/api/v2
```

## Authentication

Authenticate by first obtaining an access token from:

```http theme={"dark"}
https://auth.interactsms.com/token
```

```text title="Token endpoint" icon=lock wrap theme={"dark"}
https://auth.interactsms.com/token
```

Then include the access token in the `Authorization` header on every API request:

```http title="Authorization header" highlight={1} icon=key wrap theme={"dark"}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Request format

All request bodies should be JSON with `Content-Type: application/json`.

## Response codes

| Code  | Meaning                                        |
| ----- | ---------------------------------------------- |
| `200` | OK — request succeeded                         |
| `201` | Created — resource created successfully        |
| `400` | Bad Request — invalid parameters               |
| `401` | Unauthorized — invalid or missing access token |
| `422` | Unprocessable Entity — validation error        |
| `429` | Too Many Requests — rate limit exceeded        |
| `500` | Internal Server Error                          |