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

# API overview

> Authenticate and call the Costory HTTP API. Use a bearer token from the Costory app for every request.

The Costory API exposes the same endpoints the app uses over HTTP. Base URL:

```bash theme={null}
https://app-api.costory.io
```

Start with the [Reports API](/api/overview) to create and schedule cost reports. More resources (Events, Teams, and others) are listed in this API Reference tab as they ship.

## Authentication

All requests use a bearer token in the `Authorization` header. Create a user-scoped token or an organization-scoped token (admins only) in the [Costory app](https://app.costory.io/).

```bash theme={null}
Authorization: Bearer <your-api-token>
```

<Frame caption="Create a user scoped token">
  <img src="https://mintcdn.com/costory/JTfvymumgsDgNwGk/images/api/authentication.png?fit=max&auto=format&n=JTfvymumgsDgNwGk&q=85&s=c2b334377c87e9f1a1b71a38bf2ae944" alt="Create a user scoped token in Costory settings" width="252" height="453" data-path="images/api/authentication.png" />
</Frame>