Skip to main content

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

ParameterTypeDescription
doc_idstringDocument 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

FieldTypeDescription
doc_idstringDocument identifier
document_urlstringURL to the primary source
article_titlestringDocument title
summarystringBrief summary
source_namestringPublishing organization
published_datestring | nullPublication date
extraction_statusstring"complete" when all insights have been extracted

insights fields

FieldTypeDescription
insight_idstringUnique insight identifier
titlestringShort title for the insight
insightstringThe extracted finding as a complete statement
excerptsstring[]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"