API REFERENCE
Clear endpoints. Clear responses.
POST /v1/ocr
POST /v1/markdown
POST /v1/extract
GET /v1/jobs/{id}
Webhooks
Errors
{ "id": "doc_123", "pages": 3, "markdown": "# Report" }Upload a PDF or image. Jobs return a document ID. All endpoints use Bearer authentication.
AUTHENTICATION
Send one authenticated request.
Every API call uses the same Bearer token. Keep it on your server, not in browser code.
Bearer token
Pass the project key in the Authorization header.
Upload a file
Attach a PDF, PNG, JPEG, or WEBP file.
Read the result
Use the document ID, page count, and requested output.
Authorization: Bearer $STARTOCR_API_KEY
ASYNC + ERRORS
Handle the real production path.
Use an async job for longer work and branch from clear error codes.
Create a job
Submit a document and keep the returned ID.
Wait for completion
Poll the job or receive a webhook callback.
Retry safely
Retry only documented transient errors and keep the request ID.