Skip to main content
POST
Parse a document image

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
model
string
required
Example:

"cohere/parse-v5.0"

document
object
required
models
string[]

Optional ordered fallback models tried after model. model is required and is always the primary model. When an attempt fails with 429, 500, 502, 503, or 504, the next entry is tried; other errors are returned unchanged. Accepts up to 25 model IDs or presets; duplicates and entries equal to model are ignored. Each attempt is validated, logged, and billed as its own request, and the response model field and routing trace show the model that served the request. Streaming requests fall back only before the first byte, and video and music jobs fall back only at submission. Batch, realtime, and council requests reject models. Fallbacks set on a dynamic route take precedence, and phaseo/auto cannot be combined with models.

Required array length: 1 - 25 elements
Minimum string length: 1
Example:
output_format
enum<string>
default:markdown
Available options:
markdown,
blocks
echo_upstream_request
boolean
debug
object

Gateway debug controls. These flags are never forwarded upstream.

provider
object

Provider routing preferences for gateway selection.

routing
object

Provider routing preferences for gateway selection.

Response

200 - application/json

Parsed document

id
string
required
object
enum<string>
required
Available options:
parse
model
string
required
provider
string
required
pages
object[]
required
meta
object
usage
object
Last modified on October 18, 2026