DocuParse API Documentation

curl -X POST "https://YOUR_DOMAIN/api/v1/extract" \
  -H "Authorization: Bearer dex_your_api_key_here" \
  -F "file=@receipt.pdf"

Authorization: Bearer dex_your_api_key_here

curl -X POST "https://YOUR_DOMAIN/api/v1/extract" \
  -H "Authorization: Bearer dex_your_api_key" \
  -F "file=@receipt.pdf"

// IMPORTANT: Run this server-side only. Never expose your API key in the browser.
// Store API_KEY in an environment variable.

const fs = require("fs");
const path = require("path");

async function extractDocument(filePath) {
  const apiKey = process.env.DOCUEXTRACT_API_KEY; // e.g. "dex_..."

  const form = new FormData();
  const fileBuffer = fs.readFileSync(filePath);
  const filename = path.basename(filePath);
  const blob = new Blob([fileBuffer]);
  form.append("file", blob, filename);

  const res = await fetch("https://YOUR_DOMAIN/api/v1/extract", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
    },
    body: form,
  });

  const data = await res.json();

  if (!data.success) {
    // data.error.code is one of: MISSING_API_KEY, INVALID_API_KEY,
    // REVOKED_API_KEY, LIMIT_EXCEEDED, UNSUPPORTED_FILE_TYPE,
    // FILE_TOO_LARGE, EXTRACTION_FAILED, INTERNAL_ERROR
    throw new Error(`[${data.error.code}] ${data.error.message}`);
  }

  return data;
}

// Usage
extractDocument("./receipt.pdf")
  .then((result) => {
    console.log("Document ID:", result.document_id);
    console.log("Status:", result.status);
  })
  .catch(console.error);

// app/api/upload-receipt/route.ts
// This is a Next.js App Router API route that proxies the call to DocuParse.
// The secret API key stays on the server.

import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const apiKey = process.env.DOCUEXTRACT_API_KEY;
  if (!apiKey) {
    return NextResponse.json({ error: "Server misconfiguration." }, { status: 500 });
  }

  // Forward the multipart form from the client to DocuParse
  const formData = await req.formData();
  const file = formData.get("file");

  if (!file || !(file instanceof File)) {
    return NextResponse.json({ error: "No file provided." }, { status: 400 });
  }

  const upstream = new FormData();
  upstream.append("file", file);

  const res = await fetch("https://YOUR_DOMAIN/api/v1/extract", {
    method: "POST",
    headers: { Authorization: `Bearer ${apiKey}` },
    body: upstream,
  });

  const data = await res.json();

  if (!data.success) {
    return NextResponse.json(
      { error: data.error.message, code: data.error.code },
      { status: res.status }
    );
  }

  return NextResponse.json(data);
}

# IMPORTANT: Run server-side only. Store your key in an environment variable.
import os
import requests

def extract_document(file_path: str) -> dict:
    api_key = os.environ["DOCUEXTRACT_API_KEY"]  # e.g. "dex_..."

    with open(file_path, "rb") as f:
        response = requests.post(
            "https://YOUR_DOMAIN/api/v1/extract",
            headers={"Authorization": f"Bearer {api_key}"},
            files={"file": (os.path.basename(file_path), f)},
        )

    data = response.json()

    if not data.get("success"):
        # Structured error: data["error"]["code"] and data["error"]["message"]
        raise RuntimeError(f"[{data['error']['code']}] {data['error']['message']}")

    return data


# Usage
result = extract_document("receipt.pdf")
print("Merchant:", result["data"]["merchant"])
print("Total:", result["data"]["total"])
print("Status:", result["status"])

// DEMO ONLY — DO NOT EXPOSE API KEYS IN BROWSER CODE
// Use this pattern only in a backend/server-side context.

const form = new FormData();
form.append("file", fileInput.files[0]);

const res = await fetch("https://YOUR_DOMAIN/api/v1/extract", {
  method: "POST",
  headers: {
    // In real production: call YOUR backend instead, never put the key here
    Authorization: "Bearer dex_your_api_key",
  },
  body: form,
});

const data = await res.json();
if (data.success) {
  console.log(data.data);
} else {
  console.error(data.error.code, data.error.message);
}

{
  "success": true,
  "document_id": "doc_clx7abc123",
  "status": "queued",
  "message": "Document queued for extraction."
}

curl -X GET "https://YOUR_DOMAIN/api/v1/documents/doc_clx7abc123"   -H "Authorization: Bearer dex_your_api_key"

{
  "success": true,
  "document_id": "doc_clx7abc123",
  "status": "completed",
  "data": {
    "merchant": "Office Depot",
    "currency": "USD",
    "subtotal": 42.00,
    "tax": 3.50,
    "total": 45.50
  }
}

{
  "success": false,
  "document_id": "doc_clx7abc123",
  "status": "failed",
  "error": {
    "code": "EXTRACTION_FAILED",
    "message": "Document extraction failed."
  }
}