Quickstart

Convert your first file in 5 minutes.

1. Authentication

Free-tier conversions need no credentials — skip straight to step 2.

For authenticated (higher-quota) requests, send your Indox external_token as a Bearer header on every call:

Authorization: Bearer <external_token>

Tokens are issued by Google/Apple sign-in or OIDC — see Auth. The Authorization header is optional on free-tier requests.

2. Start a conversion

curl -X POST https://indox.org/api/v1/pdf_handler/convert/ \
  -H "Authorization: Bearer eyJ…" \
  -F "[email protected]" \
  -F "target_formats=pdf"

Response (202 Accepted):

{
  "id": "8f3c…",
  "status": "pending",
  "destination": "aws",
  "requested_formats": ["pdf"],
  "target_formats": ["pdf"],
  "service": "doc"
}

3. Poll status

curl https://indox.org/api/v1/pdf_handler/conversion/8f3c…/ \
  -H "Authorization: Bearer eyJ…"

Until status is completed (or failed).

4. Download

curl -L https://indox.org/api/v1/pdf_handler/8f3c…/download/ \
  -H "Authorization: Bearer eyJ…" \
  -o report.pdf

That's it. See Concepts for what each piece does, Document Conversion for the full contract, and Limits for free-tier and paid quotas.