API Reference - FlexOrch

Base URL

https://api.flexorch.com/v1

All requests require either an API key or a JWT token:

# API key
-H "X-API-KEY: dfx_your_key_here"

# JWT token
-H "Authorization: Bearer eyJ..."

All responses follow the same envelope:

{
  "data": { ... }
}

Errors:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message"
  }
}

Code	HTTP	Description
`INVALID_API_KEY`	401	Key not found or revoked
`TRIAL_EXPIRED`	402	Trial period ended
`QUOTA_EXCEEDED`	429	Credit limit reached
`RATE_LIMIT_EXCEEDED`	429	RPM limit reached
`PLAN_UPGRADE_REQUIRED`	403	Feature not available on your plan
`FILE_TOO_LARGE`	400	File exceeds the 5 MB limit (flat across all plans)
`UNSUPPORTED_FILE`	400	File extension not supported
`EXTENSION_MISMATCH`	400	File content doesn’t match its extension, and the detected type isn’t supported either
`ENCRYPTED_PDF`	400	PDF is password-protected — remove the password and re-upload
`PDF_TOO_MANY_PAGES`	400	PDF exceeds 300 pages
`XLSX_TOO_MANY_ROWS`	400	XLSX sheet exceeds 50,000 rows

The full endpoint reference below is generated directly from the OpenAPI spec and is always up to date.