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

# Get Document

> GET /api/documents/{doc_id} — fetch a document and all its extracted insights.

## `GET /api/documents/{doc_id}`

Returns a document's metadata plus every insight extracted from it. Use this for deep research after `POST /api/insights/search` has returned a relevant `doc_id`.

### Authentication

`X-API-Key: alch_YOUR_KEY`

### Path parameters

| Parameter | Type     | Description                                                      |
| --------- | -------- | ---------------------------------------------------------------- |
| `doc_id`  | `string` | Document identifier from search results or `GET /api/documents`. |

### Response `200`

```json theme={null}
{
  "document": {
    "doc_id": "doc_01jww8y2hp6e3uaq",
    "document_url": "https://federalreserve.gov/monetarypolicy/files/fomcminutes20260319.pdf",
    "article_title": "FOMC Minutes — March 18–19, 2026",
    "summary": "The March 2026 FOMC minutes detail deliberations on the appropriate pace of policy adjustment given evolving inflation and labor market data.",
    "source_name": "Federal Reserve",
    "authors": [],
    "published_date": "2026-04-09",
    "extracted_at": "2026-04-09T15:02:00Z",
    "extraction_status": "complete",
    "ingested_at": "2026-04-09T14:58:00Z"
  },
  "insights": [
    {
      "insight_id": "ins_01jwx9z3kq7f4vbr",
      "title": "Fed median dot unchanged at 3.875% for end-2026",
      "insight": "The March 2026 SEP showed the median federal funds rate projection for year-end 2026 held at 3.875%, unchanged from December 2025.",
      "excerpts": [
        "The median projection for the federal funds rate at the end of 2026 remained at 3.875 percent."
      ]
    },
    {
      "insight_id": "ins_01jwxa...",
      "title": "Committee broadly comfortable with current policy stance",
      "insight": "Meeting participants broadly agreed that the current policy rate remained appropriate given incoming data, though several noted growing confidence in the inflation trajectory.",
      "excerpts": [
        "Participants broadly agreed that the current stance of monetary policy remained appropriate..."
      ]
    }
  ]
}
```

### `document` fields

| Field               | Type             | Description                                        |
| ------------------- | ---------------- | -------------------------------------------------- |
| `doc_id`            | `string`         | Document identifier                                |
| `document_url`      | `string`         | URL to the primary source                          |
| `article_title`     | `string`         | Document title                                     |
| `summary`           | `string`         | Brief summary                                      |
| `source_name`       | `string`         | Publishing organization                            |
| `published_date`    | `string \| null` | Publication date                                   |
| `extraction_status` | `string`         | `"complete"` when all insights have been extracted |

### `insights` fields

| Field        | Type       | Description                                     |
| ------------ | ---------- | ----------------------------------------------- |
| `insight_id` | `string`   | Unique insight identifier                       |
| `title`      | `string`   | Short title for the insight                     |
| `insight`    | `string`   | The extracted finding as a complete statement   |
| `excerpts`   | `string[]` | Verbatim source quotes that support the insight |

### Error `404`

```json theme={null}
{
  "detail": "Document not found"
}
```

### Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.askalchemist.com/api/documents/doc_01jww8y2hp6e3uaq" \
    -H "X-API-Key: alch_YOUR_KEY"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.askalchemist.com/api/documents/doc_01jww8y2hp6e3uaq",
      headers={"X-API-Key": "alch_YOUR_KEY"},
  )
  data = resp.json()
  print(data["document"]["article_title"])
  for i in data["insights"]:
      print(f"  • {i['title']}: {i['insight'][:100]}...")
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    "https://api.askalchemist.com/api/documents/doc_01jww8y2hp6e3uaq",
    { headers: { "X-API-Key": "alch_YOUR_KEY" } }
  );
  const { document, insights } = await res.json();
  ```
</CodeGroup>