Skip to main content
GET
/
api
/
v1
/
jobs
curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/jobs/" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"
[
  {
    "id": "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
    "workflow_id": "f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "workflow_name": "My ETL Workflow",
    "status": "COMPLETED",
    "created_at": "2026-01-01T00:00:00Z",
    "runtime": "PT2M30S",
    "input_file_ids": null,
    "output_node_files": [
      {
        "node_id": "n1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
        "file_id": "output-001.json",
        "node_type": "destination",
        "node_subtype": "s3"
      }
    ],
    "job_type": "ephemeral"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt

Use this file to discover all available pages before exploring further.

Query parameters

workflow_id
string
Filter by workflow ID.
status
string
Filter by job status.
ValueDescription
SCHEDULEDJob is queued to run.
IN_PROGRESSJob is currently running.
COMPLETEDJob finished successfully.
STOPPEDJob was manually stopped.
FAILEDJob failed to complete.

Response

id
string
required
Unique identifier for the job.
workflow_id
string
required
Unique identifier of the workflow that created this job.
workflow_name
string
required
Name of the workflow that created this job.
status
string
required
Job status.
ValueDescription
SCHEDULEDJob is queued to run.
IN_PROGRESSJob is currently running.
COMPLETEDJob finished successfully.
STOPPEDJob was manually stopped.
FAILEDJob failed to complete.
created_at
string
required
ISO 8601 timestamp when the job was created.
runtime
string
ISO 8601 duration of the job run.
input_file_ids
array
IDs of input files for this job.
output_node_files
array
Output file metadata objects. Each object includes node_id, file_id, node_type, and node_subtype.
job_type
string
Job type. Default: ephemeral.
curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/jobs/" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"
[
  {
    "id": "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
    "workflow_id": "f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "workflow_name": "My ETL Workflow",
    "status": "COMPLETED",
    "created_at": "2026-01-01T00:00:00Z",
    "runtime": "PT2M30S",
    "input_file_ids": null,
    "output_node_files": [
      {
        "node_id": "n1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
        "file_id": "output-001.json",
        "node_type": "destination",
        "node_subtype": "s3"
      }
    ],
    "job_type": "ephemeral"
  }
]