> ## 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.

# Introduction

> Access private company data, research, and financial metrics via the Sacra API

The Sacra API gives you programmatic access to private company intelligence: revenue estimates, valuations, funding rounds, research documents, events, and financial metrics — all in JSON over HTTPS.

## Base URL

All requests go to:

```
https://sacra.com/api/v1/
```

## Authentication

Every request requires an API key passed in the `Authorization` header:

```bash theme={null}
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sacra.com/api/v1/companies/?company_domain=stripe.com"
```

Create and manage API keys in your [organization settings](https://sacra.com/orgs/settings/general/).

<Warning>Never expose your API key in client-side code. All requests should be made server-side.</Warning>

## Endpoints

<CardGroup cols={2}>
  <Card title="Companies" icon="building" href="/api-reference/companies">
    Look up companies by domain. Returns profiles, revenue estimates, valuations, and metadata.
  </Card>

  <Card title="Documents" icon="file-lines" href="/api-reference/documents">
    Browse market research reports, company one-pagers, and expert interviews.
  </Card>

  <Card title="Events" icon="calendar" href="/api-reference/events">
    Funding rounds, secondary transactions, corporate actions, and company milestones.
  </Card>

  <Card title="Filings" icon="landmark" href="/api-reference/filings">
    SEC and regulatory filings for private companies.
  </Card>

  <Card title="Metrics" icon="chart-line" href="/api-reference/metrics">
    Detailed financial metrics with historical data and source citations.
  </Card>

  <Card title="Embeds" icon="window-restore" href="/api-reference/embeds">
    Ready-made embeddable widgets for valuation charts, data summaries, and research PDFs.
  </Card>

  <Card title="Categories" icon="tag" href="/api-reference/categories">
    Browse companies by category or sector.
  </Card>

  <Card title="Funding (Legacy)" icon="circle-dollar-to-slot" href="/api-reference/funding-legacy">
    Deprecated funding round endpoints. Use Events instead.
  </Card>
</CardGroup>

For a conceptual overview of the main data types, see [Companies](/concepts/companies), [Revenue](/concepts/revenue), [Events](/concepts/events), [Documents](/concepts/documents), and [News](/concepts/news).

## Pagination

Most list endpoints return paginated results. Two pagination styles are used depending on the endpoint.

**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",
    "prev_link": null,
    "after_cursor": "abc123",
    "before_cursor": null
  }
}
```

Use `page_after` and `page_before` to move through results. Follow `next_link` directly — it includes all query parameters.

**Offset-based** (categories):

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

## Rate limits

Rate limits vary by plan. See [Pricing](https://sacra.com/pricing) for plan details, or contact [support](https://support.sacra.com/) with questions.