Skip to main content

​
GET /api/documents

Returns a list of documents in the Alchemist database. Use this to discover what’s available, browse by source, or find documents published in a date range. For searching by content, use POST /api/insights/search instead — it searches across the extracted insights and returns ranked results.

​
Authentication

X-API-Key: alch_YOUR_KEY

​
Query parameters

ParameterTypeDescription
source_namestringPartial, case-insensitive match on publishing organization.
sincestring (date)ISO 8601 date (YYYY-MM-DD). Only return documents published on or after this date.
limitintegerMax documents to return. Default 50.

​
Response 200

{
  "documents": [
    {
      "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...",
      "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"
    }
  ]
}
FieldTypeDescription
doc_idstringDocument identifier — use with GET /api/documents/{doc_id}
document_urlstringURL of the primary source
article_titlestringDocument title
summarystringBrief summary of the document
source_namestringPublishing organization
authorsstring[]Author names, if available
published_datestring | nullWhen the document was published
extraction_statusstring"complete" when insights have been extracted

​
Examples

curl "https://api.askalchemist.com/api/documents?source_name=Federal+Reserve&since=2026-01-01" \
  -H "X-API-Key: alch_YOUR_KEY"