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
{
"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
{
"detail": "Document not found"
}
Examples
curl "https://api.askalchemist.com/api/documents/doc_01jww8y2hp6e3uaq" \
-H "X-API-Key: alch_YOUR_KEY"
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]}...")
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();