API reference
DocuClipper REST API for extracting structured data from bank statements, invoices, and tax forms.
The DocuClipper API documentation has moved.
→ API docs — getting started, authentication, and endpoint reference.
Quick links
- Getting started — PAT auth, presigned upload, your first extraction.
- Authentication — Personal Access Tokens (
dcp_…) for the Agent API. - For AI agents — End-to-end cURL example, MCP tool dispatch.
- OpenAPI spec — Machine-readable schema (also at
/api-docs/.well-known/openapi.json). - llms.txt — Compact reference for LLM-based clients.
Endpoint overview
Recommended (Agent API, /api/v1/agent/*): PAT auth, direct-to-S3 upload, clean JSON output.
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /agent/documents/upload-url | Get a presigned S3 upload URL |
| POST | /agent/jobs | Create an extraction job |
| GET | /agent/jobs/:id | Poll job status |
| GET | /agent/jobs/:id/transactions | Read extracted transactions (JSON or CSV) |
| GET | /agent/whoami | Verify your PAT |
| GET/POST | /agent/mcp/tools | List or execute MCP tools |
Legacy (/api/v1/protected/*): still supported for existing customers — see the per-document-type guides under /api-docs/.