---
title: "Get posts"
method: GET
path: "/v1/posts"
tags: ["Posts"]
---

# Get posts

`GET /v1/posts`

Get a paginated result for posts based on the applied filters

## Query parameters

- `offset` number
- `limit` number
- `platform` string[]
- `status` string[]

## Response `200`

Paginated data set for posts.

- object
  - `data` PostDto[], required
    - `id` string, required — Unique identifier of the post
    - `caption` string, required — Caption text for the post
    - `status` 'posted' | 'scheduled' | 'processing' | 'failed', required — Current status of the post: scheduled, processing, or posted
    - `scheduled_at` object, nullable, required — Scheduled date and time for the post
    - `platform_configurations` object, nullable, required — Platform-specific configurations for the post
    - `social_accounts` number[], required — Array of social account IDs associated with the post
    - `account_configurations` object, nullable, required — Account-specific configurations for the post
    - `media` object, nullable, required — Array of media URLs associated with the post
    - `created_at` string, required — Timestamp when the post was created
    - `updated_at` string, required — Timestamp when the post was last updated
    - `is_draft` boolean, required — If true the post will not be processed until updated
    - `warnings` string[] — Warnings about draft behavior — e.g. platforms that will publish immediately when the draft is sent
  - `meta` object, required
    - `total` number, required — Total number of items available.
    - `offset` number, required — Number of items skipped.
    - `limit` number, required — Maximum number of items returned.
    - `next` string, nullable, required — URL to the next page of results, or null if none.

## Other responses

- `500` — Internal server error when fetching posts.

---

[API](https://skmtc.dev/post-bridge/apis/post-bridge-api.md) · [All operations](https://skmtc.dev/post-bridge/apis/post-bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/post-bridge/post-bridge-api/revisions/97ae826701f6/schema)