---
title: "GET /jobs/{job_id}/events"
method: GET
path: "/jobs/{job_id}/events"
tags: ["jobs"]
---

# GET /jobs/{job_id}/events

`GET /jobs/{job_id}/events`

## Path parameters

- `job_id` string, uuid, required

## Response `200`

Successfully got job events.

- GetJobEventsResponse
  - `events` TimeStampedJobEvent[], required
    - `body` union, required — The body content of a job event
      - object
        - `event_type` 'agent_navigated', required
        - `mode` 'visual' | 'text', required
        - `url` string, required
      - object
        - `event_type` 'agent_searched', required
        - `query` string, required
        - `results` array[], required
          - string[]
      - object
        - `event_type` 'agent_saved', required
        - `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
        - `page` integer, nullable
        - `reason` string, nullable
        - `sources` string[], required
      - object
        - `event_type` 'agent_exited', required
        - `reason` string, nullable
      - object
        - `api_candidate_count` integer, required
        - `event_type` 'api_network_captured', required
        - `request_count` integer, required
        - `url` string, required
      - object
        - `code_preview` string, required
        - `event_type` 'api_js_executed', required
        - `success` boolean, required
      - object
        - `event_type` 'derived_property', required
        - `property` string, required
        - `value` string, required
      - object
        - `error` string, required
        - `event_type` 'failed', required
        - `summary` string, nullable
      - object
        - `event_type` 'completed', required
        - `message` string, nullable
      - object
        - `cached_from_job_id` string, uuid, required
        - `event_type` 'cache_hit', required
        - `message` string, nullable
      - object
        - `candidates` object[], required
        - `event_type` 'attempted_match', required
        - `match_idx` integer, nullable
        - `raw_text` string, nullable
        - `reason` string, required
        - `target` object, required
      - object
        - `datasets_in_page` integer, required
        - `event_type` 'datahub_page_fetched', required
        - `page_num` integer, required
        - `total_datasets` integer, required
      - object
        - `count` integer, required
        - `event_type` 'datahub_databases_created', required
      - object
        - `count` integer, required
        - `event_type` 'datahub_schemas_created', required
      - object
        - `column_lineage_count` integer, required
        - `event_type` 'datahub_tables_processed', required
        - `table_lineage_count` integer, required
        - `tables_created` integer, required
        - `tables_failed` integer, required
        - `tables_updated` integer, required
      - object
        - `batch_num` integer, required
        - `event_type` 'datahub_embedding_batch', required
        - `tables_in_batch` integer, required
        - `total_batches` integer, required
      - object
        - `event_type` 'viewed_pdf_page', required
        - `page_index` integer, required
    - `created_at` string, date-time, required

## Other responses

- `400` — Job not found
- `401` — Unauthorized

## Changes

- **2026-01-17** `638f4aeee087` — 1 breaking
  - added `subschema #10` to the `events/items/body` response property `oneOf` list for the response status `200`
- **2026-01-16** `bf38064d3b4b` — 1 info
  - added the optional property `events/items/body/oneOf[subschema #10]/raw_text` to the response with the `200` status
- **2026-01-15** `c59da86f3297` — 1 breaking
  - added `subschema #16` to the `events/items/body` response property `oneOf` list for the response status `200`

[Change history](https://skmtc.dev/structifyai/apis/structify/changes/jobs/:job_id/events/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)