---
title: "List posts with bounded status and provider receipts"
method: GET
path: "/publishing/posts"
tags: ["Platform"]
---

# List posts with bounded status and provider receipts

`GET /publishing/posts`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/publishing/posts`
- Auth: API key in header `Authorization`

List posts with bounded status and provider receipts.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'draft' | 'scheduled' | 'publishing' | 'published' | 'partially_published' | 'draft_sent' | 'failed' | 'cancelled'

## Response `200`

Successful response

- object
  - `posts` object[], required
    - `post_id` string, required
    - `status` string, required
    - `revision` string, required
    - `draft_input` object, nullable, required
      - `source` union, required
        - object
          - `type` 'text', required
        - object
          - `type` 'media_asset', required
          - `media_asset_id` string, uuid, required
        - object
          - `type` 'project_export', required
          - `project_id` string, uuid, required
          - `export_id` string, uuid, required
      - `caption` string, required
      - `mode` 'schedule' | 'now' | 'draft', required
      - `scheduled_for` string, date-time
      - `timezone` string, required
      - `contains_synthetic_media` boolean, required
      - `targets` union[], required
        - union
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'instagram', required
            - `share_to_story` boolean, required: Request a native Reel share. The documented Meta APIs require a manual sharing step after publication; no separate Story is uploaded.
            - `trial_reel` boolean, required
            - `trial_graduation_strategy` 'MANUAL' | 'SS_PERFORMANCE', required
            - `share_to_feed` boolean, required
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'facebook', required
            - `share_to_story` boolean, required: Request a native Reel share. The documented Meta APIs require a manual sharing step after publication; no separate Story is uploaded.
            - `video_format` 'reel' | 'video', required
            - `title` string
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'youtube', required
            - `title` string, required
            - `privacy_status` 'private' | 'unlisted' | 'public', required
            - `made_for_kids` boolean, required
            - `description` string
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'tiktok', required
            - `publish_mode` 'direct_post' | 'draft', required
            - `privacy_level` 'PUBLIC_TO_EVERYONE' | 'FOLLOWER_OF_CREATOR' | 'MUTUAL_FOLLOW_FRIENDS' | 'SELF_ONLY': Required for direct_post; choose an option returned by the account capability check.
            - `consent_accepted` boolean, required: Must be true for direct_post.
            - `allow_comment` boolean, required
            - `allow_duet` boolean, required
            - `allow_stitch` boolean, required
            - `cover_timestamp_ms` integer, required
            - `commercial_content_enabled` boolean, required
            - `brand_organic` boolean, required
            - `branded_content` boolean, required
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'linkedin', required
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'threads', required
          - object
            - `connection_id` string, uuid, required
            - `caption` string
            - `platform` 'x', required
    - `project_id` string, nullable, required
    - `export_id` string, nullable, required
    - `caption` string, nullable, required
    - `scheduled_for` string, nullable, required
    - `timezone` string, required
    - `scheduled_local` string, nullable, required
    - `targets` object[], required
      - `target_id` string, required
      - `connection_id` string, nullable, required
      - `platform` 'youtube' | 'instagram' | 'facebook' | 'tiktok' | 'linkedin' | 'threads' | 'x' | 'discord', required
      - `status` 'scheduled' | 'publishing' | 'processing' | 'published' | 'draft_sent' | 'retrying' | 'failed' | 'cancelled' | 'manual_required', required
      - `account_name` string, nullable, required
      - `approval` object, nullable, required
        - `id` string, uuid, required
        - `digest` string, required
        - `approved_by` string, uuid, required
        - `approved_at` string, date-time, required
        - `authority` 'user' | 'series_policy', required
        - `series_policy` object
          - `series_id` string, uuid, required
          - `policy_revision` integer, required
          - `occurrence_id` string, uuid, required
          - `run_id` string, uuid, required
          - `creative_usd` number, required
        - `previous_approval_ids` string[], required
      - `caption` string, nullable, required
      - `scheduled_for` string, nullable, required
      - `scheduled_local` string, nullable, required
      - `requested_publish_kind` string, nullable, required
      - `publish_kind` string, nullable, required
      - `remote_post_id` string, nullable, required
      - `remote_post_url` string, nullable, required
      - `published_at` string, nullable, required
      - `error_code` string, nullable, required
      - `error_message` string, nullable, required
      - `can_retry` boolean, required
      - `can_cancel` boolean, required
      - `can_reschedule` boolean, required
      - `next_attempt_at` string, nullable, required
      - `revision` string, required
      - `follow_ups` object[], required
        - `action` 'share_reel_to_story', required
        - `status` 'waiting_for_publication' | 'manual_required' | 'blocked', required
        - `automatic` false, required
        - `url` string, nullable, required
        - `message` string, required
    - `next_poll_after_ms` integer, nullable, required
  - `bounds` object, required
    - `limit` number, required
    - `offset` number, required
    - `total` number, required
    - `returned` number, required
    - `has_more` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

## Changes

- **2026-10-19** `35608b12471d`: 1 breaking, 2 warning, 1 info
  - the `authority` response property const value `user` was removed for the status `200`
  - added the new `series_policy` enum value to the `posts/items/targets/items/approval/anyOf[subschema #1]/authority` response property for the response status `200`
  - added the new `user` enum value to the `posts/items/targets/items/approval/anyOf[subschema #1]/authority` response property for the response status `200`
  - added the optional property `posts/items/targets/items/approval/anyOf[subschema #1]/series_policy` to the response with the `200` status

[Operation history](https://skmtc.dev/blitzreels/apis/blitzreels-api/changes/publishing/posts/get.md)

---

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