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

# Introduction

> Read-only access to your Cura portfolio over HTTP.

The Cura API gives you read-only access to the portfolio data in your workspace: your companies, their feed, and their metrics. Every request is authenticated with a workspace API key, and every response is scoped to the workspace that key belongs to.

## Base URL

All endpoints are served under a single base URL:

```
https://api.cura.inc
```

## What you can access

<Columns cols={3}>
  <Card title="Portfolio" icon="building">
    List your portfolio companies or fetch one by id.
  </Card>

  <Card title="Feed" icon="rss">
    Activity across the portfolio, or scoped to a single company.
  </Card>

  <Card title="Metrics" icon="chart-line">
    The latest reported value of each company metric.
  </Card>
</Columns>

Browse the full endpoint list in the **API reference** tab.

## Response shape

Responses follow a consistent envelope. A single resource is returned under `data`:

```json theme={null}
{
  "data": {
    "id": "c1f2…",
    "attributes": { "domain": "acme.com", "name": "Acme" }
  }
}
```

Collections return an array under `data` alongside a `pagination` object:

```json theme={null}
{
  "data": [{ "id": "c1f2…", "attributes": { "domain": "acme.com" } }],
  "pagination": { "limit": 50, "offset": 0, "hasMore": true }
}
```

Each resource carries a stable `id` and an `attributes` object holding its fields. See [Pagination](/pagination) for how to page through collections.

## Errors

Errors use standard HTTP status codes and return a JSON body with an `error` message:

```json theme={null}
{ "error": "Portfolio company not found" }
```

| Status | Meaning                                        |
| ------ | ---------------------------------------------- |
| `400`  | Invalid query parameters.                      |
| `401`  | Missing or invalid API key.                    |
| `404`  | The resource does not exist in your workspace. |

<Card title="Authenticate your first request" icon="key" href="/authentication">
  Create a key and make a call.
</Card>