---
title: "List Workflows"
method: GET
path: "/api/v3/meta/bases/{baseId}/workflows"
tags: ["Workflows"]
---

# List Workflows

`GET /api/v3/meta/bases/{baseId}/workflows`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/bases/{baseId}/workflows`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/bases/:baseId/workflows/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of workflows associated with a specific base.

**Note**: Workflow APIs are available on cloud-hosted **Business** plans and above, and on licensed self-hosted deployments (**Business** plan and above).

## Path parameters

- `baseId` string, required

## Response `200`

Workflow list retrieved.

- WorkflowList
  - `list` object[], required
    - `id` string, required: Unique identifier for the workflow
    - `title` string, required: Title of the workflow
    - `description` string, nullable: Description of the workflow
    - `base_id` string, required: Unique identifier for the base
    - `workspace_id` string, required: Unique identifier for the workspace
    - `enabled` boolean: Whether the workflow is enabled
    - `created_at` string, date-time: Timestamp when the workflow was created
    - `updated_at` string, date-time: Timestamp when the workflow was last updated
    - `created_by` string: User ID of the creator
    - `updated_by` string: User ID of the last updater

## Other responses

- `403`: Authenticated, but not allowed: the role is too low, the token scope does not cover the operation, or the plan does not include the feature or allows no more of this resource.
- `500`: Unexpected server error. The body carries `message` only — no `error` code.

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)