> For the complete documentation index, see [llms.txt](https://therappai.gitbook.io/therappai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://therappai.gitbook.io/therappai-docs/documentation/getting-started/quickstart.md).

# therappai Quick Start

A 5-minute guide to make your first request and see results.

This guide will help you make your first successful request to the therappai API.\
You’ll learn how to access the base URL, authenticate using a bearer token, and send your first API call.

***

### **Base URL**

All requests to the therappai API are made to the following root:

**Production**

```
https://api.therappai.com/api/v1
```

***

### **Authentication**

The therappai API uses **JWT-based Bearer authentication**.

To access most endpoints, you must first log in using the `/login/` endpoint.\
A successful login returns:

* **access token** — used in all API requests
* **refresh token** — used to generate a new access token

You’ll include the access token in the `Authorization` header:

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

#### Example of an authenticated header:

```
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR...
Content-Type: application/json
```

***

### **Before you start**

You will need:

* A **therappai user account** (via `/signup/` or in-app)
* Your **access token** from `/login/`
* A tool to test API calls (Postman, cURL, or your application code)

***

### **Step 1 — Create an account (Signup)**

Send a `POST` request to:

```
POST /signup/
```

Body fields typically include:

* email
* name
* password
* confirm\_password

If the user already exists, skip to login.

***

### **Step 2 — Log in & get your access token**

```
POST /login/
```

On success, you’ll receive:

* `access` — use this for API requests
* `refresh` — store this securely on the client for refreshing sessions

***

### **Step 3 — Make your first authenticated request**

Try fetching the user profile:

```
GET /profile/
Authorization: Bearer ACCESS_TOKEN_HERE
```

If the token is valid, you’ll get basic user info back (name, email, profile picture, etc.).

***

### **Step 4 — Refreshing tokens**

When your access token expires, call:

```
POST /refresh/
```

Send the `refresh` token in the body.\
You’ll receive a **new access token** to continue making requests.

***

### **Testing your setup**

If everything works, you should be able to:

* Authenticate
* Retrieve profile data
* Begin using the core API features

From here, you can integrate:

* Users
* AI chat
* Content
* Moods
* Daily tasks
* Emergency contacts

***

#### **Need help?**

If you run into issues while getting started, contact:

**<developer@therappai.com>**