Skip to main content
Get your first document extracted in 5 minutes. This guide walks you through obtaining an API key and uploading a document.

​
Integration Overview

​
Prerequisites

  • A DocIntell account (sign up here)
  • A PDF document to extract (or use our sample invoice)
  • curl or your favorite HTTP client

​
Step 1: Get Your API Key

1

Log in to Dashboard

Go to app.docintell.com and sign in.
2

Navigate to API Keys

Click Settings → API Keys in the sidebar.
3

Create a New Key

Click Create API Key, give it a name (e.g., “Development”), and select the environment:
  • Live (dk_live_...) — Production use
  • Test (dk_test_...) — Development and testing
4

Copy Your Key

Your API key is only shown once! Copy it now and store it securely.

​
Step 2: Ingest a Document

Upload your first PDF to DocIntell. The API accepts documents up to 100MB. 
curl -X POST https://api.docintell.com/v1/documents \
  -H "Authorization: Bearer dk_live_YOUR_API_KEY" \
  -F "file=@invoice.pdf" \
  -F "retention_years=7"
Response (202 Accepted): 
{
  "document_id": "019370ab-c123-7def-8901-234567890abc",
  "job_id": "019370ab-c456-7def-8901-234567890def",
  "status": "pending",
  "vault_uri": "gs://docintell-vault/tenant-xxx/2025/019370ab.pdf",
  "created_at": "2025-12-03T10:30:00Z"
}
The 202 Accepted response means your document is queued for processing. Extraction typically completes in under 60 seconds for a 50-page document.

​
Step 3: Check Job Status

Poll the job status until extraction completes: 
curl -X GET https://api.docintell.com/v1/jobs/019370ab-c456-7def-8901-234567890def \
  -H "Authorization: Bearer dk_live_YOUR_API_KEY"
Response (completed): 
{
  "job_id": "019370ab-c456-7def-8901-234567890def",
  "document_id": "019370ab-c123-7def-8901-234567890abc",
  "status": "completed",
  "created_at": "2025-12-03T10:30:00Z",
  "processing_completed_at": "2025-12-03T10:30:45Z",
  "processing_time_seconds": 45.2
}
Pro tip: Use webhooks instead of polling for production workloads. DocIntell will POST to your endpoint when extraction completes.
Congratulations! You’ve successfully uploaded your first document for extraction.

​
What’s Next?

Webhooks

Set up real-time notifications

Error Handling

Handle errors gracefully

API Reference

Complete API documentation

​
Common Issues

Check that your API key is correct and included in the Authorization header with the Bearer prefix.
Only PDF files are supported. Ensure your file has a .pdf extension and correct MIME type.
Maximum file size is 100MB. For larger documents, consider splitting them.
You’ve exceeded the rate limit. Check the Retry-After header and try again later.