---
title: "List jobs"
method: GET
path: "/processing/v1/jobs"
tags: ["Jobs"]
---

# List jobs

`GET /processing/v1/jobs`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/processing/v1/jobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/processing/v1/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

List the jobs of a workflow, typically to find the failed one, most recently submitted first.

Restrict the result to one workflow with the `workflow` parameter, typically combined with `status=FAILED`
to find the failed job of a failed workflow. Omit `workflow` to list jobs across all workflows.

The response is paginated in the same way as the [List workflows](#tag/workflows/GET/processing/v1/workflows) response.

## Query parameters

- `after` string
- `before` string
- `size` integer
- `workflow` string, uri: A URN identifying a processing workflow. Format: urn:ata:{tenant}:processing:workflow:{uuid} Example: urn:ata:acme-corp:processing:workflow:123e4567-e89b-12d3-a456-426614174000.
- `type` string
- `status` string
- `name` string
- `sort` string

## Response `200`

Paginated list of processing jobs.

- object
  - `meta` CursorPaginationMetadata, required: Pagination metadata for cursor-based pagination.
    - `prev` string: Cursor for previous page. Use with 'before' query parameter. Omitted on the first page.
    - `next` string: Cursor for next page. Use with 'after' query parameter. Omitted on the last page.
    - `total` integer: Optional total count of items.
  - `data` ProcessingJob[], required
    - `urn` string, uri, required: A URN identifying a processing job. Format: urn:ata:{tenant}:processing:job:{uuid} Example: urn:ata:acme-corp:processing:job:123e4567-e89b-12d3-a456-426614174000.
    - `type` string, required: Type of the job.
    - `name` string: Human-readable name of the job.
    - `submittedAt` string, date-time, required: When the job was submitted to the workflow.
    - `startedAt` string, date-time: When the job started running.
    - `finishedAt` string, date-time: When the job finished.
    - `duration` integer: Duration of the job.
    - `status` string, required: @ExtensibleEnum The current status of the processing job: `PENDING` (not started yet), `RUNNING`, `FINISHED` (completed successfully), `FAILED` (did not complete — see `error`), `CANCELED`, or `SKIPPED` (there was nothing to run). The set is extensible.
    - `error` object: Failure details, present when the job failed.
      - `reason` string: Why the job failed.

## Other responses

- `403`: Forbidden. You do not have permission to access the requested resource.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)