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

# Quickstart - Getting started

> Get started with the Sacra API in minutes

## Get your API key

Before making requests you need an organization API token. If you don't have a Sacra account yet, [sign up](https://sacra.com/signup/) to get started.

> [accordion] Create an API token
>
> 1. Sign in to [Sacra](https://sacra.com/login) and navigate to your organization settings.
> 2. Go to **API Keys** and click **Create API Key**.
> 3. Give the key a name (e.g. `my-app`) and copy the token — you won't be able to see it again.

> [accordion] Authenticate your requests
>
> Pass the token in the `Authorization` header on every request:
>
> ```bash theme={null}
> curl -H "Authorization: Token YOUR_API_KEY" \
>   "https://sacra.com/api/v1/companies/?company_domain=stripe.com"
> ```
>
> A successful response confirms your token is valid:
>
> ```json theme={null}
> {
>   "company": {
>     "domain": "stripe.com",
>     "name": "Stripe",
>     "slug": "stripe"
>   }
> }
> ```

## Make your first request

> [accordion] Look up a company
>
> Fetch company data by domain:
>
> ```bash theme={null}
> curl -H "Authorization: Token YOUR_API_KEY" \
>   "https://sacra.com/api/v1/companies/?company_domain=stripe.com"
> ```

> [accordion] List documents for a company
>
> Get the latest research documents for a company:
>
> ```bash theme={null}
> curl -H "Authorization: Token YOUR_API_KEY" \
>   "https://sacra.com/api/v1/documents/?company_domain=stripe.com"
> ```
>
> > [!TIP]
> >
> > Use `page_after` and `page_before` cursors from the `pagination` object to page through results.

> [accordion] Search across all content
>
> Search documents and companies by keyword:
>
> ```bash theme={null}
> curl -X POST \
>   -H "Authorization: Token YOUR_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{"query": "fintech revenue"}' \
>   https://sacra.com/api/v1/search/
> ```

## Core concepts

> [card] [Companies](https://docs.sacra.com/api-reference/companies/list-companies.md)
>
> Look up companies by domain, slug, or ID. Returns financials, milestones, and metadata.

> [card] [Documents](https://docs.sacra.com/api-reference/documents/list-documents.md)
>
> Browse market research, company one-pagers, and interview transcripts.

> [card] [Search](https://docs.sacra.com/api-reference/documents/search.md)
>
> Full-text search across all documents and companies.

> [card] [Events & Metrics](https://docs.sacra.com/api-reference/events/get-aggregated-events.md)
>
> Access company events and financial metrics.

## Pagination

Most list endpoints return paginated results. The `pagination` object in each response tells you how to fetch the next page.

**Cursor-based** (documents, events, metrics, news):

```json theme={null}
{
  "pagination": {
    "page_size": 30,
    "total_items": 142,
    "next_link": "https://sacra.com/api/v1/documents/?page_after=abc123"
  }
}
```

**Offset-based** (search, category items):

```json theme={null}
{
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 85,
    "next_offset": 20
  }
}
```

> [!TIP]
>
> Follow the `next_link` URL directly — it includes all the query parameters you need.

## Next steps

> [card] [API reference](https://docs.sacra.com/api-reference)
>
> Explore the full API reference with request and response schemas.

> [card] [Display company data](https://docs.sacra.com/guides/display-company-data.md)
>
> Embed company data, charts, and research documents into your site.

> [card] [Revenue](https://docs.sacra.com/concepts/revenue.md)
>
> Understand revenue data types, datapoint periods, and how to interpret financial data.

> [card] [MCP server](https://docs.sacra.com/mcp-overview.md)
>
> Connect to the Sacra MCP server for AI agent integration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.