---
title: "List all the executions"
method: GET
path: "/jobs/list"
tags: ["jobs"]
---

# List all the executions

`GET /jobs/list`

## Query parameters

- `offset` integer
- `limit` integer
- `dataset` string, nullable
- `status` 'Queued' | 'Running' | 'Completed' | 'Failed'
- `since` string, date-time, nullable
- `job_type` 'Web' | 'Pdf' | 'Derive' | 'Scrape' | 'Match' | 'ConnectorExplore'
- `seeded_kg_search_term` string, nullable
- `node_id` string, uuid

## Response `200`

A list of all execution histories

- ListJobsResponse[]
  - `created_at` string, date-time, required
  - `dataset_id` string, uuid, required
  - `id` string, uuid, required
  - `job_type` 'Web' | 'Pdf' | 'Derive' | 'Scrape' | 'Match' | 'ConnectorExplore', required
  - `message` string, nullable
  - `parameters` JobInput
    - `allow_extra_entities` boolean, required
    - `extraction_criteria` SaveRequirement[], required
      - union — It's an OR statement across these.
        - RequiredRelationship
          - `relationship_name` string, required
        - RequiredEntity
          - `entity_id` string, uuid
          - `seeded_entity_id` integer, required — The integer id corresponding to an entity in the seeded entity graph (different from the global dataset entity id)
        - RequiredProperty
          - `property_names` string[], required — If there are multiple properties, it can match just one of them
          - `table_name` string, required — The table name of the entity to update
    - `instructions` string, nullable
    - `model` string, nullable
    - `seeded_kg` LLMKnowledgeGraph, required — Knowledge graph info structured to deserialize and display in the same format that the LLM outputs. Also the first representation of an LLM output in the pipeline from raw tool output to being merged into a DB
      - `entities` LLMEntity[], required
        - `id` integer, required
        - `properties` object, required
        - `type` string, required
      - `relationships` LLMRelationship[]
        - `properties` object
        - `source` integer, required
        - `target` integer, required
        - `type` string, required
    - `structuring_input` union, required
      - object
        - `Agent` union, required — These are all the types that can be converted into a BasicInputType
          - object
            - `PDF` PDFIngestor, required — Ingest all pages of a PDF and process them independently.
              - …
          - object
            - `Web` WebSearch, required
              - …
      - object
        - `TransformationPrompt` string, required
      - object
        - `ScrapeFromUrlProperty` ScrapePageInput, required
          - `batch_scrape` boolean, required
          - `url_property_name` string, required
          - `use_markdown` boolean, required
      - object
        - `ScrapeUrl` ScrapePageUrlInput, required
          - `batch_scrape` boolean, required
          - `url` string, required
          - `use_markdown` boolean, required
      - object
        - `ConnectorExploration` ConnectorExplorationInput, required
          - `connector_id` string, uuid, required
          - `exploration_phase_id` union, required — Identifies the phase of connector exploration This enum is used to track which phase of exploration a chat session belongs to. It's stored as JSONB in the database to allow for flexible phase identification.
            - object — First phase: discovering all databases in the connector
              - …
            - object — Second phase: discovering all schemas in a database
              - …
            - object — Third phase: discovering all tables in a schema
              - …
            - object — Fourth phase: discovering columns for a specific table
              - …
            - object — Initial phase: discovering all API resources
              - …
            - object — Second phase: discovering fields for a specific API resource
              - …
          - `exploration_run_id` string, uuid, required
          - `stage` 'both' | 'ingestion' | 'annotation', required — Which exploration stage to run
  - `reason` string, nullable
  - `run_started_time` string, date-time, nullable
  - `run_time_milliseconds` integer, nullable
  - `special_job_type` 'HumanLLM'
  - `status` 'Queued' | 'Running' | 'Completed' | 'Failed', required
  - `user_id` string, uuid, required

## Changes

- **2026-01-21** `817198e84647` — 1 warning, 1 info
  - removed the optional property `items/parameters/allOf[#/components/schemas/JobInput]/structuring_input/oneOf[subschema #1]/Agent/oneOf[subschema #1]/PDF/single_agent` from the response with the `200` status
  - added the optional property `items/parameters/allOf[#/components/schemas/JobInput]/structuring_input/oneOf[subschema #1]/Agent/oneOf[subschema #1]/PDF/page` to the response with the `200` status
- **2026-01-21** `d4cc893e9116` — 1 warning, 1 info
  - removed the optional property `items/parameters/allOf[#/components/schemas/JobInput]/structuring_input/oneOf[subschema #1]/Agent/oneOf[subschema #1]/PDF/page` from the response with the `200` status
  - added the optional property `items/parameters/allOf[#/components/schemas/JobInput]/structuring_input/oneOf[subschema #1]/Agent/oneOf[subschema #1]/PDF/single_agent` to the response with the `200` status
- **2026-01-21** `45952f7cb8cb` — 1 warning, 1 info
  - removed the optional property `items/parameters/allOf[#/components/schemas/JobInput]/structuring_input/oneOf[subschema #1]/Agent/oneOf[subschema #1]/PDF/single_agent` from the response with the `200` status
  - added the optional property `items/parameters/allOf[#/components/schemas/JobInput]/structuring_input/oneOf[subschema #1]/Agent/oneOf[subschema #1]/PDF/page` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/structifyai/apis/structify/changes/jobs/list/get.md)

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)