---
title: "List Job Logs"
method: GET
path: "/jobs/{job_id}/logs"
tags: ["Jobs"]
---

# List Job Logs

`GET /jobs/{job_id}/logs`

## Request

- Base URL: `https://api.hedra.com/v3`
- URL: `https://api.hedra.com/v3/jobs/{job_id}/logs`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

## Path parameters

- `job_id` string, required: The job's id (`job_<uuid>`).

## Query parameters

- `limit` integer: Maximum items per page.
- `cursor` string, nullable: Opaque cursor from the previous page's `next_cursor`; omit for the first page.

## Response `200`

Successful Response

- JobLogListResponse
  - `data` JobLogItem[], required: This page of items.
    - `id` integer, required: Monotonically increasing id of this event within the job's log. Cursors are separate opaque values (`next_cursor` / `logs_next_cursor`); do not send this id as one.
    - `timestamp` string, date-time, required: ISO-8601 instant the event was recorded.
    - `level` 'info' | 'warning' | 'error', required
    - `event` 'queued' | 'started' | 'moderation.passed' | 'provider.submitted' | 'provider.error' | 'retry.scheduled' | 'progress' | 'finalizing' | 'download.ready' | 'completed' | 'failed' | 'recovered', required
    - `message` string, required: Human-readable summary of the event.
    - `source` 'api' | 'worker' | 'provider' | 'cron', required
    - `data` object: Structured detail specific to this event type; empty when the event carries none.
  - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null when this response completes the list. Always present. Endpoints that serve the whole collection at once always return null.

## Other responses

- `400`: Invalid or failed-validation request.
- `401`: Authentication failed: missing, malformed, or invalid credentials.
- `403`: Insufficient scope or plan.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: Internal error.

## Changes

- **2026-10-16** `06692d16e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/jobs/:job_id/logs/get.md)

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedra-labs/apis/hedra-api/revisions/6ef35a11cefe?raw)