---
title: "List posts"
method: GET
path: "/v1/posts"
---

# List posts

`GET /v1/posts`

## Request

- Base URL: `https://api.clipflow.co`
- URL: `https://api.clipflow.co/v1/posts`
- Auth: OAuth 2
  - Authorization code: `https://app.clipflow.co/oauth/authorize`
  - Token URL: `https://app.clipflow.co/oauth/token` scopes: `posts.read`

## Query parameters

- `after` string
- `limit` integer
- `channel_id` string
- `expand` string
- `organization_id` string
- `platform_key` string
- `platform_product_id` string
- `platform_product_key` string
- `post_status` 'declined' | 'draft' | 'changes_required' | 'reviewed' | 'ready' | 'done' | 'failed'
- `scheduled_after` string, date-time
- `scheduled_before` string, date-time
- `tags[]` string[]
- `title` string

## Response `200`

Success

## Other responses

- `401`: Missing or invalid token
- `403`: Token lacks the required scope
- `404`: Not found

---

[API](https://skmtc.dev/clipflow/apis/clipflow-api.md) - [All operations](https://skmtc.dev/clipflow/apis/clipflow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clipflow/apis/clipflow-api/revisions/0d20cd281ba0?raw)