# Getting Started

URL: /docs/api-reference

Source: https://github.com/easypanel-io/monorepo/blob/main/apps/website/content/docs/api-reference/index.mdx

Authenticate and make your first API request.



The Easypanel API lets you manage your panel programmatically using the same
operations available in the dashboard.

## Base URL [#base-url]

API requests use your Easypanel URL followed by `/api`:

```text
https://panel.example.com/api
```

Replace `panel.example.com` with the domain of your Easypanel installation.

## Authentication [#authentication]

Most endpoints require a bearer token.

1. Call the [Log in](/docs/api-reference/authentication/login) endpoint with
   your email and password.
2. Read the token from the response.
3. Include it in the `Authorization` header of subsequent requests:

```http
Authorization: Bearer YOUR_API_TOKEN
```

Keep the token private and never expose it in client-side code or commit it to
source control.

## Make your first request [#make-your-first-request]

Use the authenticated session endpoint to verify your connection:

```bash
curl --request GET \
  --url https://panel.example.com/api/getSession \
  --header "Authorization: Bearer YOUR_API_TOKEN"
```

A successful response returns the current authenticated session. You can now
use the same authorization header with the other endpoints in this reference.