Developer API Docs

Integrate Saraka's intelligent document classifications and semantic search capabilities into your application.

1. Authentication

All API requests must contain your secret API key passed inside the HTTP header parameter: `Authorization: Bearer YOUR_API_KEY`.

curl -X GET "https://api.saraka-dms.com/v1/me" \
  -H "Authorization: Bearer sk_live_4a821fb832"

2. Document Ingestion

Ingest any PDF, scan, or office document into your private vector index. Our engines automatically run OCR text extractions and generate embeddings.

POST /v1/documents
{
  "file_url": "https://yourbucket.s3.amazonaws.com/invoice.pdf",
  "folder_id": "folder_finance_99",
  "enable_ocr": true
}

3. AI Classifications

Classify documents into department categories, extract invoice totals, metadata dates, and compliance risk factors using customized LLM pipelines.

POST /v1/classify
{
  "document_id": "doc_8f93a102",
  "schema": {
    "total_amount": "number",
    "vendor": "string",
    "due_date": "date"
  }
}