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

# Tawked developer docs

> OTP verification and WhatsApp messages for Saudi mobile numbers, in a few HTTP calls.

Tawked sends a one-time code to a Saudi mobile number and checks the code the person typed. Two calls, one prepaid balance, billed only per delivered code. Approved applications can also send WhatsApp template messages through their own number.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Start a verification and check a code in five minutes, with a sandbox key.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/verify/start-a-verification">
    Every endpoint with an interactive playground, generated from the live OpenAPI document.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/errors">
    Every error code the API returns, its HTTP status, and what to do about it.
  </Card>

  <Card title="WhatsApp messages" icon="whatsapp" href="/whatsapp/overview">
    Send approved templates through the number connected to your application.
  </Card>
</CardGroup>

## The shape of the API

|                |                                                                                     |
| -------------- | ----------------------------------------------------------------------------------- |
| Base URL       | `https://tawked.com`                                                                |
| Authentication | `Authorization: Bearer <key>` or `x-api-key: <key>`                                 |
| Format         | JSON in, JSON out, UTF-8                                                            |
| Rate limit     | 120 requests per minute per key                                                     |
| Price          | SAR 0.09 per delivered SMS code, prepaid; failed sends are not charged              |
| Request id     | Every response carries an `X-Request-Id` header. Quote it when you contact support. |

Both `/v1/...` and `/api/v1/...` answer identically. New integrations should use `/v1/...`.

## Machine-readable

The same reference is published for tools and agents: an [OpenAPI 3.1 document](https://tawked.com/openapi.json), an [llms.txt index](https://tawked.com/llms.txt) and the [full reference as Markdown](https://tawked.com/llms-full.txt). All three are generated from one source, so they never disagree with these pages.