DocuExtract API

Send a document, get JSON back. No templates. No training. Works in 5 minutes.

DocuExtract converts unstructured documents — invoices, receipts, contracts, resumes, bank statements — into clean, validated JSON using Claude AI. You send a document (image, PDF, or URL), specify what you want extracted, and receive structured data in seconds.

Quick Start

Extract structured data from a document in 3 steps.

curl https://docuextract.dev/v1/extract \
  -H "Authorization: Bearer dk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "https://example.com/invoice.pdf",
    "type": "invoice"
  }'

const response = await fetch('https://docuextract.dev/v1/extract', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer dk_live_YOUR_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    document: 'https://example.com/invoice.pdf',
    type: 'invoice',
  }),
});

const result = await response.json();
console.log(result.data);
// { vendor_name: "Acme Corp", total_amount: 1250.00, ... }

import requests

response = requests.post(
    'https://docuextract.dev/v1/extract',
    headers={
        'Authorization': 'Bearer dk_live_YOUR_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'document': 'https://example.com/invoice.pdf',
        'type': 'invoice',
    }
)

result = response.json()
print(result['data'])
# {'vendor_name': 'Acme Corp', 'total_amount': 1250.0, ...}

{
  "data": {
    "vendor_name": "Acme Corp",
    "invoice_number": "INV-2024-0847",
    "invoice_date": "2024-03-15",
    "due_date": "2024-04-15",
    "subtotal": 1000.00,
    "tax_amount": 250.00,
    "total_amount": 1250.00,
    "currency": "USD",
    "line_items": [
      { "description": "Consulting services", "quantity": 10, "unit_price": 100.00, "total": 1000.00 }
    ]
  },
  "metadata": {
    "type": "invoice",
    "confidence": 0.96,
    "model": "claude-haiku-4-5-20251001",
    "processing_time_ms": 1847,
    "page_count": 1
  }
}

Authentication

All API endpoints (except GET /v1/health) require authentication via a Bearer token in the Authorization header.

Authorization: Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxx

API Key Format

API keys start with dk_live_ followed by 32 random characters. Keys are generated when you sign up and can be regenerated from your dashboard.

Rate Limit Headers

Every authenticated response includes rate limit information:

POST /v1/extract

Extract structured data from a document. This is the core endpoint.

Request Body

Response

{
  "data": { /* extracted fields */ },
  "metadata": {
    "type": "invoice",
    "confidence": 0.96,
    "model": "claude-haiku-4-5-20251001",
    "processing_time_ms": 1847,
    "page_count": 1
  }
}

POST /v1/detect

Detect the type of a document without extracting its data.

Response

{
  "type": "invoice",
  "confidence": 0.98
}

GET /v1/usage

Retrieve your current usage statistics for the billing period.

Response

{
  "used": 847,
  "limit": 10000,
  "plan": "pro",
  "period_end": "2024-04-24",
  "breakdown": [
    { "date": "2024-03-24", "count": 42 }
  ]
}

GET /v1/health

Health check endpoint. No authentication required.

{ "status": "ok", "version": "1.0.0" }

POST /v1/billing/checkout

Create a Stripe Checkout session to subscribe to a paid plan. Returns a URL to redirect your user to for payment.

Request Body

Response

{ "url": "https://checkout.stripe.com/c/pay/cs_live_..." }

Redirect the user to this URL. After payment, Stripe redirects back to your dashboard.

POST /v1/billing/portal

Create a Stripe Billing Portal session for subscription management.

Response

{ "url": "https://billing.stripe.com/p/session/..." }

Document Types

DocuExtract automatically detects document types, or you can specify one explicitly.

Error Codes

All errors return a JSON response with an error object containing code and message fields.

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

4xx Client Errors

5xx Server Errors

Pricing

Simple, transparent pricing. No credit multipliers, no enterprise-gating.

Overage Pricing

When you exceed your monthly quota, additional extractions are billed at $0.05 per extraction.