Check asynchronous conversion status
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
SUCCESSorERROR - Maximum processing time: 60 minutes (auto-timeout)
Authorization
ApiKeyAuth Bearer token for API authentication
In: header
Path Parameters
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
Get document type by ID GET
Retrieves details of a specific document type based on user permissions