---
title: "List workflows"
method: GET
path: "/processing/v1/workflows"
tags: ["Workflows"]
---

# List workflows

`GET /processing/v1/workflows`

## Request

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

List the processing workflows in your environment, most recently started first.

Filter by `status` (for example, `RUNNING` or `FAILED`), by `type` (for example, `DQ-JOB` for DQ monitor processings),
or by `name`. Use the `urn` of a listed workflow to retrieve, poll, or cancel it.

The response contains a `data` array with up to `size` workflows, and a `meta` object with the `prev` and `next` pagination cursors.
A cursor is `null` when there are no further pages in that direction.

## Query parameters

- `after` string
- `before` string
- `size` integer
- `status` string
- `type` string
- `name` string
- `sort` string

## Response `200`

Paginated list of processing workflows.

- 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` ProcessingWorkflow[], required
    - `urn` string, uri, required: 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, required: Type of the workflow, for example `DQ-JOB` for a DQ monitor processing.
    - `name` string: Human-readable name of the workflow.
    - `owner` string
    - `startedAt` string, date-time, required: When the workflow started.
    - `finishedAt` string, date-time: When the workflow finished.
    - `duration` integer: Duration of the run.
    - `status` string, required: @ExtensibleEnum The current status of the processing workflow. - `PENDING`: not started yet — keep polling. - `RUNNING`: in progress — keep polling. - `FINISHED`: completed successfully; its results are ready to retrieve. - `FAILED`: did not complete — see `errors`. No results are available for this run. - `CANCELED`: canceled before completion. No results are available for this run. - `SKIPPED`: there was nothing to run (for example, the DQ monitor has no rules assigned). No results are available for this run. `PENDING` and `RUNNING` are the only non-terminal values. The set is extensible, so treat any value you do not recognize as not-success: proceed to results only on `FINISHED`.
    - `errors` object[]: Failures of a `FAILED` workflow — one entry per failed job, carrying the URN of the job and the failure `reason`. Empty when no job failed. Retrieve the job for further details.
      - `job` 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.
      - `reason` string, required: 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)