Get step execution status

GET
/api/steps-async/status/{executionId}

Retrieves the current status and results of a step execution with standardized response format.

Status values:

  • ENQUEUED: Request received, waiting to be processed
  • PROCESSING: Currently being processed
  • SUCCESS: Processing completed successfully
  • ERROR: Processing failed

Polling recommendation:

  • Poll every 1-2 seconds for small documents
  • Poll every 3-5 seconds for large documents or PDFs

Authorization

ApiKeyAuth
AuthorizationBearer <token>

Bearer token for API authentication

In: header

Path Parameters

executionId*string

Step execution ID returned from the execute step endpoint

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.docutray.com/api/steps-async/status/cm5vm9hx30001m5cgh0p9v8qa"
{
  "conversion_id": "cm5vm9hx30001m5cgh0p9v8qa",
  "status": "ENQUEUED",
  "request_timestamp": "2024-01-15T10:30:00.000Z"
}
{
  "message": "Invalid execution ID format"
}
{
  "error": "Invalid API key"
}
{
  "message": "Access denied to this execution"
}
{
  "message": "Execution not found"
}
{
  "error": "Rate limit exceeded",
  "limitType": "minute",
  "limit": 0,
  "remaining": 0,
  "resetTime": 0,
  "retryAfter": 0
}
{
  "message": "Internal server error: Failed to retrieve execution status"
}