API
ConceptsThe API (Application Programming Interface) is the DocLD REST API that provides programmatic access to all core capabilities: document upload and parsing, extraction, RAG chat, knowledge base management, and workflow automation. Integrate DocLD into your applications using standard HTTP requests with JSON payloads.
API Overview
DocLD exposes RESTful endpoints organized by capability:
| Area | Endpoints | Description |
|---|---|---|
| Documents | /api/documents, /api/upload | Upload, list, and manage documents |
| Extraction | /api/extract, /api/extract/schemas | Run extraction, manage schemas |
| Chat | /api/chat, /api/sessions | RAG chat, session management |
| Knowledge bases | /api/knowledge-bases | Create and configure knowledge bases |
| Webhooks | /api/webhooks | Register webhook callbacks |
| Workflows | /api/workflows | Define and trigger workflows |
Authentication uses API keys passed in the Authorization header or as a Bearer token. Rate limits and quotas apply per plan.
How to Use the API
- Obtain an API key — Generate keys from the DocLD dashboard under Settings
- Choose base URL — Use the DocLD API base URL for your region
- Send requests — Use
POST,GET,PUT, orDELETEwith JSON bodies as documented - Handle responses — Responses include status codes, pagination where relevant, and error details
Example: Upload a document and trigger parsing:
curl -X POST "https://api.docld.com/api/upload" \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@invoice.pdf"
Async Operations
Many operations are asynchronous. Extraction and parsing return a job ID. Poll the job endpoint or use webhooks to be notified when processing completes.
Related Concepts
The API powers extraction, parsing, and workflow automation. Use webhooks for event-driven integrations.