API REFERENCE
Clear endpoints. Clear responses.
POST /v1/markdown
{ "id": "doc_123", "pages": 3, "markdown": "# Report" }Upload a PDF or image. Jobs return a document ID.
All endpoints use Bearer authentication. See errors and limits per endpoint.
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.
Authorization: Bearer $STARTOCR_API_KEY
Upload a file
Attach a PDF, PNG, JPEG, or WEBP file.
-F file=@document.pdf
Read the result
Use the document ID, page count, and requested output.
RESPONSE JSON
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.
POST /v1/jobs
Wait for completion
Poll the job or receive a webhook callback.
GET /v1/jobs/{id}
Retry safely
Retry only documented transient errors and keep the request ID.
ERRORS + RETRIES