getStepExecutionStatus

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`

curl -X GET "https://app.docutray.com/api/steps-async/status/cm5vm9hx30001m5cgh0p9v8qa"

{
  "execution_id": "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"
}

getStepExecutionStatus

Get step execution status

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`