# therappai Quick Start

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>**