API reference · v2.4

Submit OCR job

Submit an image or PDF for structured extraction. Returns a taskId you can poll for results.

POSThttps://startocr.com/api/v2/ocr

Headers

Name	Type	Required	Description
`Authorization`	string	Required	`Bearer <API_KEY>`
`Content-Type`	string	Required	Must be `application/json`.

Request body

Name	Type	Required	Description
`imageBase64`	string	Required	Base64-encoded file, max 10 MB.
`filename`	string	Required	Original filename including extension.
`options`	object	Optional	Extraction options: `format`, `highFidelityTables`, `formulas`.

Example request

cURL

curl -X POST "https://startocr.com/api/v2/ocr" \
  -H "Authorization: Bearer sk_live_2KQy..." \
  -H "Content-Type: application/json" \
  -d '{
    "imageBase64": "data:image/png;base64,iVBORw...",
    "filename": "invoice_2026_q2.png",
    "options": {
      "format": "markdown",
      "highFidelityTables": true,
      "formulas": true
    }
  }'

Response

200 OK · application/json

{
  "taskId": "task_9f8d2a1b",
  "status": "queued",
  "estimatedSeconds": 3.2,
  "pages": 1,
  "creditsUsed": 1
}