Developers /Docs API

Parse a document

Parse a document. Waits up to timeout ms; past it, 202 {id, url, progress}.

POST/docs/v1/parse
POST example
curl --request POST \
  --url 'https://factget.dev/docs/v1/parse' \
  --header "Authorization: Bearer $FACTGET_DOCS_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "fileId": "YOUR_FILE_ID",
  "pages": "1-5"
}'

Replace IDs and sample values with your own. Examples are not executed in your browser.

Authorization

Authorizationstring · header · required

Bearer Docs API key with the required scope. Learn about authentication →

Request body

application/json
fileIdstring | null

A file from POST /v1/files

urlstring | null

A public URL of the document

pagesstring | null

Pages to read, e.g. "1-10" or "3,7,12-15"

timeoutinteger

ms to wait before 202

Default: 60000minimum: 1000maximum: 300000
Provide either a fileId from an upload or a public document URL.

Responses

200Successful Response
application/json

The published schema does not define individual response fields for this endpoint. Inspect the returned JSON in your integration.

422Validation Error
application/json
detailobject[]
Show item properties
locstring | integer[]required
msgstringrequired
typestringrequired
inputobject
ctxobject

The API schema lists the responses above. Long-running operations can also return 202; see async jobs. For application errors, see errors & retries.