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

# List posts

`GET /posts`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/posts`
- Auth: HTTP bearer

## Query parameters

- `creator_id` string
- `status` 'scheduled'
- `include` string
- `limit` integer

## Response `200`

Posts

- PostsResponse
  - `data` union[]
    - union
      - Post
        - `id` string
        - `author_id` string
        - `creator_id` string: Alias used by preview responses; raw post rows may use author_id.
        - `status_id` string, nullable
        - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
        - `platform` 'linkedin' | 'x' | 'twitter' | 'null', nullable
        - `content` string
        - `topic` string, nullable
        - `first_comment` string, nullable
        - `scheduled_for` string, date-time, nullable
        - `generated_image_url` string, nullable
        - `uploaded_image_url` string, nullable
        - `document_url` string, nullable
        - `video_url` string, nullable
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
      - PostPreview
        - `id` string
        - `creator_id` string
        - `status_id` string, nullable
        - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
        - `content` string
        - `topic` string, nullable
        - `first_comment` PostFirstComment, nullable
          - `content` string
        - `scheduled_for` string, date-time, nullable
        - `media` PostPreviewMedia[]
          - `type` 'image' | 'carousel_slide' | 'video'
          - `url` string, nullable
          - `order` integer
          - `alt_text` string, nullable
        - `raw` Post
          - `id` string
          - `author_id` string
          - `creator_id` string: Alias used by preview responses; raw post rows may use author_id.
          - `status_id` string, nullable
          - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
          - `platform` 'linkedin' | 'x' | 'twitter' | 'null', nullable
          - `content` string
          - `topic` string, nullable
          - `first_comment` string, nullable
          - `scheduled_for` string, date-time, nullable
          - `generated_image_url` string, nullable
          - `uploaded_image_url` string, nullable
          - `document_url` string, nullable
          - `video_url` string, nullable
          - `created_at` string, date-time, nullable
          - `updated_at` string, date-time, nullable

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)