---
title: "Get workflows list"
method: GET
path: "/platform/v1/workflows"
tags: ["Workflows"]
---

# Get workflows list

`GET /platform/v1/workflows`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/platform/v1/workflows`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:workflows:read`, `api:workflows:execute`

Get a list of workflows with optional filters and pagination

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `sort` string
- `filter[runnableOnDemand]` boolean
- `filter[active]` boolean
- `filter[name]` string

## Response `200`

Success

- WorkflowsListResponse: Response containing a list of workflows
  - `data` Workflow[], required: The primary data of the document
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` WorkflowAttributes, required: Attributes for a workflow in the list response
      - `name` string, required: Name of the workflow
      - `active` boolean, required: Activation status of the workflow
      - `runnableOnDemand` boolean, required: Whether the workflow can be executed on demand
      - `lastUpdated` string, date-time, required: Last update timestamp
      - `createdAt` string, date-time, required: Created timestamp
  - `meta` GetWorkflowsMeta: Metadata for the current page of workflows returned
    - `page` integer, required: The current page of workflows being returned
    - `pageSize` integer, required: The page size as specified by the request
    - `totalCount` integer, required: The total count of workflows within the current search parameters
  - `links` GetWorkflowsLinks: Links describing the various workflows paging options
    - `first` string, uri: A link to the first page of data
    - `last` string, uri: A link to the last page of data
    - `prev` string, uri: A link to the previous page of data
    - `next` string, uri: A link to the next page of data

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/platform-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/platform-api-v1/revisions/3f7645433626?raw)
