---
title: "List automation flows"
method: GET
path: "/flows"
tags: ["Flows"]
---

# List automation flows

`GET /flows`

## Request

- Base URL: `https://www.sociahive.com/api/v1`
- URL: `https://www.sociahive.com/api/v1/flows`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `/api/oauth/authorize`, token URL `/api/oauth/token`, scopes: `flows:read`)

## Query parameters

- `platform_user_id` string, required: The connected account's `platform_user_id`. Returns up to 200 flows, newest first.

## Response `200`

Flows

- FlowListEnvelope: GET /flows returns `{ flows: [...] }` — raw flow documents decorated with total_triggers / unique_users / unique_clickers, and `scheduled_post` on a flow that belongs to a scheduled post (when post automations are on). Not paginated.
  - `flows` object[], required
    - `scheduled_post` FlowScheduledPostChip
      - `id` string, required
      - `scheduled_at` string, date-time, nullable, required
      - `status` string, required: The post status (open-ended), e.g. `draft`, `scheduled`, `published`.
      - `thumbnail_url` string, nullable, required

## Other responses

- `400`: Bad request — invalid parameters
- `401`: Authentication required — provide X-API-Key or Bearer token
- `403`: Insufficient scope for this operation
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/sociahive/apis/sociahive-api.md) · [All operations](https://skmtc.dev/sociahive/apis/sociahive-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociahive/apis/sociahive-api/revisions/791b8548d288?raw)