> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> How to authenticate with Composio APIs using project and organization API keys

Every Composio API request authenticates with an API key. Send the key in a request header and Composio resolves it to your project or organization.

## Project API key

A project API key authenticates to one project with full access. Send it in the `x-api-key` header.

Get it from the dashboard: sign in to [composio.dev](https://composio.dev), open **Settings → Project Settings**, and copy the key from the **API Keys** section.

## Organization API key

An organization API key authenticates across every project in your organization. Send it in the `x-org-api-key` header.

Get it from the dashboard: open **Organization Settings → General Settings** and copy a token under **Organization Access Tokens**.

## Using the API key

Include your API key in the request header:

> [tab] Python
>
> ```python theme={null}
> from composio import Composio
>
> composio = Composio()
> print(composio.client.get("/api/v3/tools", cast_to=object))
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
>
> const composio = new Composio();
> console.log(await composio.getClient().get<unknown>('/api/v3/tools'));
> ```

> [tab] API
>
> ```bash theme={null}
> curl -X GET https://backend.composio.dev/api/v3/tools \
>   -H "x-api-key: $COMPOSIO_API_KEY"
> ```

For organization-level endpoints:

The Python SDK also requires `COMPOSIO_API_KEY` to initialize. These raw calls explicitly send the organization header for the historical v3 route.

> [tab] Python
>
> ```python theme={null}
> import os
> from composio import Composio
>
> composio = Composio()
> projects = composio.client.get(
>     "/api/v3/org/owner/project/list",
>     cast_to=object,
>     headers={"x-api-key": None, "x-org-api-key": os.environ["COMPOSIO_ORG_API_KEY"]},
> )
> print(projects)
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
>
> const composio = new Composio({
>   apiKey: null,
>   userApiKey: null,
>   orgApiKey: process.env.COMPOSIO_ORG_API_KEY,
> });
> console.log(await composio.getClient().get<unknown>('/api/v3/org/owner/project/list'));
> ```

> [tab] API
>
> ```bash theme={null}
> curl -X GET https://backend.composio.dev/api/v3/org/owner/project/list \
>   -H "x-org-api-key: $COMPOSIO_ORG_API_KEY"
> ```

> [card] [Errors](https://composio-preview.mintlify.site/reference/v3/errors.md)
>
> Understanding API error responses

> [card] [Rate Limits](https://composio-preview.mintlify.site/reference/v3/rate-limits.md)
>
> API rate limits by plan
