Developer API

Parse a document in one request.

Create an API key in your workspace, upload a supported file, then poll the document endpoint or receive a signed webhook.

Authentication

Send your key as a Bearer token. Keys are shown once and stored as SHA-256 hashes.

Authorization: Bearer pb_live_your_key

Upload a document

curl -X POST https://www.parsebuddy.com/api/v1/documents \
  -H "Authorization: Bearer pb_live_your_key" \
  -H "Accept: application/json" \
  -F "document=@invoice.pdf"

Returns 202 Accepted with a stable document ID.

Retrieve structured results

GET /api/v1/documents/{document_id}

{
  "status": "completed",
  "document_type": "invoice",
  "confidence": 0.97,
  "data": { "invoice_number": "INV-1048" }
}

Verify webhooks

Compute HMAC-SHA256 over timestamp.payload using the endpoint secret, then compare it to X-ParseBuddy-Signature. Deduplicate with the delivery ID header.