---
title: "List Posts"
method: GET
path: "/open-api/v1.1/memberships/posts"
tags: ["Posts"]
---

# List Posts

`GET /open-api/v1.1/memberships/posts`

## Query parameters

- `page` integer
- `limit` integer
- `search_query` string
- `types[]` string[]
- `ids[]` integer[]
- `state` 'Published' | 'Scheduled' | 'All', required
- `tags_ids[]` integer[]

## Headers

- `X-ShopId` string

## Response `200`

- object
  - `posts` union[], required
    - union
      - ResponseV1FeedPostText
        - `id` integer
        - `type` 'Text', required
        - `title` string, required
        - `description` string
        - `liveAt` string, date-time, required
        - `path` string, required
        - `access` object, required
          - `tiers` ResponseCommonId[]
            - `id` integer, required
          - `type` 'Plans' | 'MembersOnly' | 'Public' | 'FreeMembers' | 'FreeAndPaidMembers' | 'Paid' | 'PaidAndPaidMembers' | 'PaidAndTiers', required
          - `price` integer, nullable
        - `notifications` union, required
          - ResponseV1FeedPostNotificationEnabled
            - `type` 'Enabled', required
          - ResponseV1FeedPostNotificationDisabled
            - `type` 'Disabled', required
        - `tags` ResponseCommonId[], required
          - `id` integer, required
        - `statuses` ResponseV1FeedPostStatuses, required
          - `resources` 'None' | 'Created' | 'Processing' | 'Completed' | 'Errored', required
          - `post` 'Created' | 'Ready' | 'Live' | 'Finished' | 'Archived', required
          - `schedule` 'None' | 'Asap' | 'Future' | 'Done', required
        - `comments` ResponseV1FeedPostComments, required
          - `count` integer, required
        - `likes` ResponseV1FeedPostLikes, required
          - `count` integer, required
        - `purchaseData` ResponseV1FeedPostPurchaseData, required
          - `purchasesCount` integer, required
        - `pinnedAt` string, date-time
      - ResponseV1FeedPostPoll
        - `id` integer
        - `type` 'Poll', required
        - `title` string, required
        - `description` string
        - `liveAt` string, date-time, required
        - `finishedAt` string, date-time, required
        - `path` string, required
        - `access` object, required
          - `tiers` ResponseCommonId[]
            - `id` integer, required
          - `type` 'Plans' | 'MembersOnly' | 'Public' | 'FreeMembers' | 'FreeAndPaidMembers' | 'Paid' | 'PaidAndPaidMembers' | 'PaidAndTiers', required
          - `price` integer, nullable
        - `notifications` union, required
          - ResponseV1FeedPostNotificationEnabled
            - `type` 'Enabled', required
          - ResponseV1FeedPostNotificationDisabled
            - `type` 'Disabled', required
        - `tags` ResponseCommonId[], required
          - `id` integer, required
        - `statuses` ResponseV1FeedPostStatuses, required
          - `resources` 'None' | 'Created' | 'Processing' | 'Completed' | 'Errored', required
          - `post` 'Created' | 'Ready' | 'Live' | 'Finished' | 'Archived', required
          - `schedule` 'None' | 'Asap' | 'Future' | 'Done', required
        - `options` ResponseV1FeedPostPollOption[], required
          - `title` string, required
          - `votes` object, required
            - `amount` number, required
            - `percentage` number, required
        - `votesAmount` integer, required
        - `comments` ResponseV1FeedPostComments, required
          - `count` integer, required
        - `likes` ResponseV1FeedPostLikes, required
          - `count` integer, required
        - `purchaseData` ResponseV1FeedPostPurchaseData, required
          - `purchasesCount` integer, required
        - `pinnedAt` string, date-time
      - ResponseV1FeedPostAudio
        - `id` integer
        - `type` 'Audio', required
        - `title` string, required
        - `description` string
        - `liveAt` string, date-time, required
        - `path` string, required
        - `access` object, required
          - `tiers` ResponseCommonId[]
            - `id` integer, required
          - `type` 'Plans' | 'MembersOnly' | 'Public' | 'FreeMembers' | 'FreeAndPaidMembers' | 'Paid' | 'PaidAndPaidMembers' | 'PaidAndTiers', required
          - `price` integer, nullable
        - `notifications` union, required
          - ResponseV1FeedPostNotificationEnabled
            - `type` 'Enabled', required
          - ResponseV1FeedPostNotificationDisabled
            - `type` 'Disabled', required
        - `tags` ResponseCommonId[], required
          - `id` integer, required
        - `mediaUrl` string, required
        - `image` ResponseV1FeedPostImageCustom, required
          - `type` 'Custom', required
          - `thumbnailUrl` string, required
          - `url` string, required
        - `statuses` ResponseV1FeedPostStatuses, required
          - `resources` 'None' | 'Created' | 'Processing' | 'Completed' | 'Errored', required
          - `post` 'Created' | 'Ready' | 'Live' | 'Finished' | 'Archived', required
          - `schedule` 'None' | 'Asap' | 'Future' | 'Done', required
        - `comments` ResponseV1FeedPostComments, required
          - `count` integer, required
        - `likes` ResponseV1FeedPostLikes, required
          - `count` integer, required
        - `purchaseData` ResponseV1FeedPostPurchaseData, required
          - `purchasesCount` integer, required
        - `pinnedAt` string, date-time
      - ResponseV1FeedPostVideo
        - `id` integer
        - `type` 'Video', required
        - `title` string, required
        - `description` string
        - `liveAt` string, date-time, required
        - `path` string, required
        - `access` object, required
          - `tiers` ResponseCommonId[]
            - `id` integer, required
          - `type` 'Plans' | 'MembersOnly' | 'Public' | 'FreeMembers' | 'FreeAndPaidMembers' | 'Paid' | 'PaidAndPaidMembers' | 'PaidAndTiers', required
          - `price` integer, nullable
        - `notifications` union, required
          - ResponseV1FeedPostNotificationEnabled
            - `type` 'Enabled', required
          - ResponseV1FeedPostNotificationDisabled
            - `type` 'Disabled', required
        - `tags` ResponseCommonId[], required
          - `id` integer, required
        - `mediaUrl` string, required
        - `image` union
          - ResponseV1FeedPostImageCustom
            - `type` 'Custom', required
            - `thumbnailUrl` string, required
            - `url` string, required
          - ResponseV1FeedPostImageMux
            - `type` 'Mux', required
            - `thumbnailUrl` string, required
            - `url` string, required
          - ResponseV1FeedPostImageNone
            - `type` 'None', required
        - `statuses` ResponseV1FeedPostStatuses, required
          - `resources` 'None' | 'Created' | 'Processing' | 'Completed' | 'Errored', required
          - `post` 'Created' | 'Ready' | 'Live' | 'Finished' | 'Archived', required
          - `schedule` 'None' | 'Asap' | 'Future' | 'Done', required
        - `comments` ResponseV1FeedPostComments, required
          - `count` integer, required
        - `likes` ResponseV1FeedPostLikes, required
          - `count` integer, required
        - `purchaseData` ResponseV1FeedPostPurchaseData, required
          - `purchasesCount` integer, required
        - `customSubtitles` object, required
          - `filename` string, required
          - `uploadedAt` string, date-time, required
        - `autoGeneratedSubtitles` object, nullable
          - `url` string, required
        - `countryRestrictions` string[]
        - `pinnedAt` string, date-time
        - `updatedAt` string, date-time, required
      - ResponseV1FeedPostVideoEmbed
        - `id` integer
        - `type` 'VideoEmbed', required
        - `title` string, required
        - `description` string
        - `liveAt` string, date-time, required
        - `path` string, required
        - `access` object, required
          - `tiers` ResponseCommonId[]
            - `id` integer, required
          - `type` 'Plans' | 'MembersOnly' | 'Public' | 'FreeMembers' | 'FreeAndPaidMembers' | 'Paid' | 'PaidAndPaidMembers' | 'PaidAndTiers', required
          - `price` integer, nullable
        - `notifications` union, required
          - ResponseV1FeedPostNotificationEnabled
            - `type` 'Enabled', required
          - ResponseV1FeedPostNotificationDisabled
            - `type` 'Disabled', required
        - `tags` ResponseCommonId[], required
          - `id` integer, required
        - `embed` union, required
          - ResponseV1FeedPostComponentsVideoEmbedYoutube
            - `type` 'Youtube', required
            - `videoId` string, required
            - `url` string, required
          - ResponseV1FeedPostComponentsVideoEmbedStreamable
            - `type` 'Streamable', required
            - `videoId` string, required
            - `url` string, required
          - ResponseV1FeedPostComponentsVideoEmbedVimeo
            - `type` 'Vimeo', required
            - `videoId` string, required
            - `url` string, required
        - `image` union
          - ResponseV1FeedPostImageCustom
            - `type` 'Custom', required
            - `thumbnailUrl` string, required
            - `url` string, required
          - ResponseV1FeedPostImageNone
            - `type` 'None', required
        - `statuses` ResponseV1FeedPostStatuses, required
          - `resources` 'None' | 'Created' | 'Processing' | 'Completed' | 'Errored', required
          - `post` 'Created' | 'Ready' | 'Live' | 'Finished' | 'Archived', required
          - `schedule` 'None' | 'Asap' | 'Future' | 'Done', required
        - `comments` ResponseV1FeedPostComments, required
          - `count` integer, required
        - `likes` ResponseV1FeedPostLikes, required
          - `count` integer, required
        - `purchaseData` ResponseV1FeedPostPurchaseData, required
          - `purchasesCount` integer, required
        - `pinnedAt` string, date-time
        - `updatedAt` string, date-time, required
      - ResponseV1FeedPostImage
        - `id` integer
        - `type` 'Image', required
        - `title` string, required
        - `description` string
        - `liveAt` string, date-time, required
        - `path` string, required
        - `access` object, required
          - `tiers` ResponseCommonId[]
            - `id` integer, required
          - `type` 'Plans' | 'MembersOnly' | 'Public' | 'FreeMembers' | 'FreeAndPaidMembers' | 'Paid' | 'PaidAndPaidMembers' | 'PaidAndTiers', required
          - `price` integer, nullable
        - `notifications` union, required
          - ResponseV1FeedPostNotificationEnabled
            - `type` 'Enabled', required
          - ResponseV1FeedPostNotificationDisabled
            - `type` 'Disabled', required
        - `tags` ResponseCommonId[], required
          - `id` integer, required
        - `imageResources` ResponseV1FeedPostImageResourceWithPosition[], required
          - `type` 'ResourceWithPosition', required
          - `resourceId` integer, required
          - `position` integer, required
        - `image` ResponseV1FeedPostImageCustom, required
          - `type` 'Custom', required
          - `thumbnailUrl` string, required
          - `url` string, required
        - `statuses` ResponseV1FeedPostStatuses, required
          - `resources` 'None' | 'Created' | 'Processing' | 'Completed' | 'Errored', required
          - `post` 'Created' | 'Ready' | 'Live' | 'Finished' | 'Archived', required
          - `schedule` 'None' | 'Asap' | 'Future' | 'Done', required
        - `comments` ResponseV1FeedPostComments, required
          - `count` integer, required
        - `likes` ResponseV1FeedPostLikes, required
          - `count` integer, required
        - `purchaseData` ResponseV1FeedPostPurchaseData, required
          - `purchasesCount` integer, required
        - `pinnedAt` string, date-time
  - `pagination` ResponseV1Pagination, required
    - `pages` integer, required
    - `limit` integer, required
    - `page` integer, required
    - `total` integer

## Other responses

- `400`

---

[API](https://skmtc.dev/fourthwall/apis/openapi.md) · [All operations](https://skmtc.dev/fourthwall/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fourthwall/openapi/revisions/c6887a2f069b/schema)