---
title: "List All Workflow IDs"
method: GET
path: "/workflows/ids"
tags: ["Workflows"]
---

# List All Workflow IDs

`GET /workflows/ids`

## Request

- Base URL: `https://ironcladapp.com/public/api/v1`
- URL: `https://ironcladapp.com/public/api/v1/workflows/ids`
- Auth: API key in header `Authorization` and OAuth 2
  - Authorization code: `https://ironcladapp.com/oauth/authorize`
  - Client credentials
  - Token URL: `https://ironcladapp.com/oauth/token` scopes: `public.workflows.readWorkflows`

Returns only the identifiers of the workflows you can access, without workflow bodies, schemas, or attributes. Use this to determine which workflows are visible to your credentials without paying the cost of a full workflow listing.

Filtering and pagination behave the same as [List All Workflows](https://developer.ironcladapp.com/reference/list-all-workflows). Because each result contains only identifiers, `pageSize` may be set as high as 10000.

Results are always ordered by when the workflow was last updated; `sortDirection` controls only the direction.

This endpoint reflects indexed workflow visibility and does not load each workflow individually, so in rare cases it may list a workflow whose full representation is temporarily unavailable from [List All Workflows](https://developer.ironcladapp.com/reference/list-all-workflows).

**OAuth Scope required:** `public.workflows.readWorkflows`

## Query parameters

- `page` integer
- `pageSize` integer
- `status` union
  - string
  - string[]
- `template` string
- `sortDirection` 'ASC' | 'DESC'
- `lastUpdated` string
- `filter` string
- `search` string

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

200

- object
  - `page` integer
  - `pageSize` integer
  - `count` integer
  - `list` IdReferenceModel[]
    - `id` string, required: The unique identifier of the object
    - `ironcladId` string: The human-readable identifier of the object as displayed in Ironclad. Omitted when no readable identifier has been assigned to the object.

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404

## Changes

- **2026-11-03** `435da5a4396e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/changes/workflows/ids/get.md)

---

[API](https://skmtc.dev/ironcladapp/apis/ironclad-public-api.md) - [All operations](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/revisions/435da5a4396e?raw)