DocuTray
API ReferenceDocuTray.com
API ReferenceConversion

Check asynchronous conversion status

GET
/api/convert-async/status/{id}

Retrieve the current status and result of an asynchronous conversion.

Status flow:

  • ENQUEUED → PROCESSING → SUCCESS | ERROR

Polling recommendations:

  • Poll every 2-3 seconds for active conversions
  • Stop polling when status is SUCCESS or ERROR
  • Maximum processing time: 60 minutes (auto-timeout)

Authorization

ApiKeyAuth
AuthorizationBearer <token>

Bearer token for API authentication

In: header

Path Parameters

id*string

Unique conversion ID to check

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.docutray.com/api/convert-async/status/cm5vm9hx30001m5cgh0p9v8qa"
{
  "conversion_id": "cm5vm9hx30001m5cgh0p9v8qa",
  "status": "ENQUEUED",
  "request_timestamp": "2024-01-15T10:30:00.000Z",
  "document_type_code": "invoice",
  "original_filename": "invoice_001.pdf"
}
{
  "error": "Invalid API key"
}
{
  "error": "Access denied to this conversion"
}
{
  "error": "Conversion not found"
}
{
  "message": "Internal server error: Failed to retrieve conversion status"
}

Start asynchronous document conversion using OCR POST

Process documents asynchronously and extract structured data using AI-powered OCR. **Supported file formats:** - image/jpeg (JPEG) - image/png (PNG) - image/gif (GIF) - image/bmp (BMP) - image/webp (WebP) - application/pdf (PDF) **Size limits:** - Maximum file size: 100MB - URL download timeout: 30 seconds **Request methods:** 1. **multipart/form-data**: Direct file upload 2. **application/json with base64**: Base64-encoded image 3. **application/json with URL**: Image URL for automatic download **Async workflow:** 1. Submit document for processing (returns conversion_id) 2. Poll `/api/convert-async/status/{id}` for completion 3. Retrieve extracted data when status is SUCCESS

Create a new document type POST

Creates a new document type. **Non-admin users:** - `isPublic` is forced to `false` - `source` is set to `USER` - `codeType` must be prefixed with the organization slug (e.g., `orgname_my_type`) - At least 3 characters required after the prefix **Admin users:** - Can set `isPublic` to `true` - `source` defaults to `ADMIN` - No prefix requirement on `codeType`