Purple8 DocIntel API
One POST. Structured knowledge back.
A REST API for document intelligence: upload any of 70+ formats in 75+ languages, get entities, relationships, tables and markdown back. Async jobs, live streams, stable IDs.
Quickstart
Authenticate with Authorization: Bearer or X-API-Key. Sandbox and paid keys use the same endpoints.
Step 1
Get an API key
Sign in to the DocIntel workspace and open “API keys & access”. Sandbox access is free and set up automatically — no subscription needed to start. The same endpoint serves sandbox and paid keys.
# Keys are managed at
# https://docintel.purple8.ai/try?view=api
export DOCINTEL_API_KEY="<your key>"Step 2
Upload a document
POST any supported file. The API answers immediately (202) with a job_id while extraction runs asynchronously. Add auto_commit=false to preview results without writing to a graph.
curl -X POST "https://docintel.purple8.ai/process" \
-H "Authorization: Bearer $DOCINTEL_API_KEY" \
-F "file=@contract.pdf"
# => { "job_id": "…", "status": "queued" }Step 3
Collect the results
Poll the job (or subscribe to its live stream). Finished jobs return the people, organisations, money, dates and relationships found — with stable IDs — plus structure-aware chunks.
curl "https://docintel.purple8.ai/jobs/$JOB_ID" \
-H "Authorization: Bearer $DOCINTEL_API_KEY"
# Markdown rendition of the whole document:
curl "https://docintel.purple8.ai/jobs/$JOB_ID/markdown" \
-H "Authorization: Bearer $DOCINTEL_API_KEY"Core endpoints
| Method | Path | What it does |
|---|---|---|
| POST | /process | Upload a file for async processing; returns a job_id (202) |
| POST | /process/url | Process a document fetched from a URL |
| GET | /jobs/{id} | Job status, entities, relationships, chunks |
| GET | /jobs/{id}/stream | Live progress over Server-Sent Events |
| GET | /jobs/{id}/markdown | Structure-aware markdown rendition |
| GET | /jobs/{id}/entities | Extracted entities for the job |
| POST | /jobs/{id}/send-to-graph | Commit results into a Purple8 Hyper Graph |
| MCP | /mcp | Same capabilities as MCP tools for AI agents |
Full schema: openapi.json · Guides: docs.docintel.purple8.ai
API pricing
Billed per page of processed output. Failed, cancelled and timed-out jobs cost nothing.
Sandbox
$0
Free evaluation keys from the workspace. Same API, same formats — capped at 50 documents per key per month.
DocIntel Cloud
$100/mo
10,000 pages/month included, then $0.01 per additional page. Project API keys for team integrations. Only finished jobs are billed.
Pay as you go
$0.015/page
Prepaid page credits, no monthly access fee. Top up any amount from $5 — most buyers start with 1,000 pages for $15. Processing draws down the balance.