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

MethodPathWhat it does
POST/processUpload a file for async processing; returns a job_id (202)
POST/process/urlProcess a document fetched from a URL
GET/jobs/{id}Job status, entities, relationships, chunks
GET/jobs/{id}/streamLive progress over Server-Sent Events
GET/jobs/{id}/markdownStructure-aware markdown rendition
GET/jobs/{id}/entitiesExtracted entities for the job
POST/jobs/{id}/send-to-graphCommit results into a Purple8 Hyper Graph
MCP/mcpSame 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.