---
title: "Returns the history of a job."
method: GET
path: "/api/v1/orchestrator/jobs/{id}/history"
tags: ["Orchestrator"]
---

# Returns the history of a job.

`GET /api/v1/orchestrator/jobs/{id}/history`

Returns the history of a job.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `since` string
- `event_type` string
- `execution_id` string
- `next_token` string

## Response `200`

OK

- ApimodelsListJobHistoryResponse
  - `Items` ModelsJobHistory[]
    - `Event` ModelsEvent
      - `Details` object — Any additional metadata that the system or user may need to know about the event in order to handle it properly.
      - `Message` string — A human-readable string giving the user all the information they need to understand and respond to an Event, if a response is required.
      - `Timestamp` string — The moment the event occurred, which may be different to the moment it was recorded.
      - `Topic` string — The topic of the event. See the documentation on EventTopic.
    - `ExecutionID` string
    - `ExecutionState` ModelsStateChangeModelsExecutionStateType
      - `New` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11
      - `Previous` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11
    - `JobID` string
    - `JobState` ModelsStateChangeModelsJobStateType
      - `New` 0 | 1 | 2 | 3 | 4 | 5 | 6
      - `Previous` 0 | 1 | 2 | 3 | 4 | 5 | 6
    - `JobVersion` integer
    - `SeqNum` integer
    - `Time` string
    - `Type` 0 | 1 | 2
  - `NextToken` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/bacalhau-project/apis/bacalhau-api.md) · [All operations](https://skmtc.net/bacalhau-project/apis/bacalhau-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bacalhau-project/bacalhau-api/revisions/9470ca2a198b/schema)