---
title: "Scheduled Posts List Route"
method: GET
path: "/scheduled_posts"
tags: ["scheduled_posts"]
---

# Scheduled Posts List Route

`GET /scheduled_posts`

## Request

- Base URL: `https://api.robopost.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.robopost.app/scheduled_posts`
- Auth: HTTP bearer

## Query parameters

- `search_text` string
- `schedule_at_from` string, date-time
- `schedule_at_to` string, date-time
- `created_at_from` string, date-time
- `created_at_to` string, date-time
- `posted_at_from` string, date-time
- `posted_at_to` string, date-time
- `state` string[]
- `social_network` SocialNetwork[]
- `social_network_from_channel_ids_for_form` SocialNetwork[]
- `channel_id` string[]
- `channel_ids_for_form` string[]
- `post_tag_id` string[]
- `channel_cat_id` string[]
- `automation_id` string[]
- `from_automation_id` string[]
- `post_collection_id` string[]
- `is_recur` boolean
- `schedule_in_the_future` boolean
- `schedule_in_the_future_max_secs` integer
- `schedule_in_the_past_min_secs` integer
- `draft_assigned_to_team_member_id` string
- `channel_cat_id_from_channel_ids_for_form` string[]
- `skip` integer
- `limit` integer
- `sort_by_field` string
- `sort_order` string

## Response `200`

Successful Response

- ScheduledPostRead[]
  - `_id` string
  - `text` string
  - `channel_social_network` 'FACEBOOK' | 'INSTAGRAM' | 'TIKTOK' | 'YOUTUBE' | 'TWITTER' | 'PINTEREST' | 'LINKEDIN' | 'GOOGLE_BUSINESS' | 'WORDPRESS' | 'GMB' | 'TELEGRAM' | 'THREADS' | 'BLUESKY': An enumeration.
  - `channel_social_object_type` 'FACEBOOK_PAGE' | 'FACEBOOK_GROUP' | 'INSTAGRAM_BUSINESS_ACCOUNT' | 'TWITTER_USER' | 'LINKEDIN_PAGE' | 'LINKEDIN_PROFILE' | 'PINTEREST_BOARD' | 'YOUTUBE_CHANNEL' | 'TIKTOK_USER' | 'WORDPRESS_HOSTED' | 'WORDPRESS_COM_WEBSITE' | 'GMB_PROFILE' | 'TELEGRAM_CHANNEL' | 'THREADS_USER' | 'BLUESKY_USER': An enumeration.
  - `channel_id` string
  - `timezone` string
  - `channel_ids_for_form` string[]
  - `link_to_url` string
  - `image_objects` object[]
  - `video_object` object
  - `additional_video_objects` object[]
  - `media_sort_order` string[]
  - `gif_object` object
  - `image_urls` string[]
  - `video_url` string
  - `gif_url` string
  - `is_channel_max_daily_posts_hit` boolean
  - `facebook_settings` object
  - `instagram_settings` object
  - `pinterest_settings` object
  - `wordpress_settings` object
  - `youtube_settings` object
  - `tiktok_settings` object
  - `gmb_settings` object
  - `video_thumbnail_uploadcare_uuid` string
  - `video_thumbnail_offset` integer
  - `video_thumbnail_ids` object[]
  - `user_id` string
  - `team_id` string
  - `state` 'SCHEDULED' | 'POSTED' | 'POSTING' | 'ERROR' | 'DRAFT' | 'DRAFT_APPROVAL' | 'DRAFT_APPROVED' | 'POST_COLLECTION' | 'DATA_LOADING': An enumeration.
  - `posted_at` string, date-time
  - `scheduled_at` string, date-time
  - `is_deleted` boolean
  - `social_post_id` string
  - `social_post_error_code` 'CHANNEL_AUTH_ERROR' | 'GENERAL_ERROR' | 'WRONG_TAG_USERNAME' | 'USAGE_LIMIT_HIT' | 'X_CREDITS_REQUIRED' | 'X_DELIVERY_UNCERTAIN' | 'DUPLICATE_CONTENT' | 'UNSUFFICIENT_PERMISSIONS' | 'INSTAGRAM_NO_MEDIA_PROVIDED' | 'FB_VIDEO_FORMAT_UNSUPPORTED' | 'INSTAGRAM_VIDEO_FORMAT_UNSUPPORTED' | 'INSTAGRAM_NOT_A_BUSINESS_ACCOUNT' | 'INSTAGRAM_RESTRICTED_ACCOUNT' | 'INSTAGRAM_ANTI_SPAM_FILTER' | 'INSTAGRAM_PAGE_REQUEST_LIMIT_REACHED' | 'INSTAGRAM_RESTRICTED_USER_ACCESS' | 'INSTAGRAM_ASPECT_RATIO_NOT_SUPPORTED' | 'INSTAGRAM_MAXIMUM_NUMBER_OF_PUBLICATIONS_REACHED' | 'INSTAGRAM_INVALID_USER' | 'INSTAGRAM_MEDIAS_COULD_NOT_BE_FETCHED' | 'TWITTER_DUPLICATE_CONTENT' | 'BLUESKY_RATE_LIMIT' | 'TIKTOK_SPAM' | 'NO_VIDEO' | 'NO_MEDIA': An enumeration.
  - `social_post_error_message` string
  - `social_post_url` string
  - `schedule_in_the_future` boolean
  - `is_posted_notification_sent` boolean
  - `post_collection_id` string
  - `post_collection_order` integer
  - `post_collection` object
  - `posting_round` integer
  - `posting_recovery_attempts` integer
  - `automation_id` string
  - `from_automation_id` string
  - `from_scheduled_post_id_in_collection` string
  - `rss_automation` boolean
  - `rss_omit_urls_on_x` boolean
  - `rss_x_fallback_text` string
  - `is_recur` boolean
  - `recur_generate_new_ai_image` boolean
  - `recur_generate_new_ai_image_model` 'Z_IMAGE' | 'DALLE' | 'FLUX_SCHNELL' | 'FLUX_DEV' | 'FLUX_PRO': An enumeration.
  - `recur_until_dt` string, date-time
  - `recur_until_dt_enabled` boolean
  - `recur_rephrase_text_with_ai` boolean
  - `recur_rephrase_text_with_ai_tone` 'POLITE' | 'WITTY' | 'ENTHUSIASTIC' | 'INFORMATIONAL' | 'FUNNY' | 'FORMAL' | 'INFORMAL' | 'HUMOROUS' | 'SERIOUS' | 'OPTIMISTIC' | 'MOTIVATING' | 'RESPECTFUL' | 'ASSERTIVE' | 'CONVERSATIONAL' | 'CASUAL' | 'PROFESSIONAL' | 'SMART' | 'NOSTALGIC' | 'FRIENDLY': An enumeration.
  - `post_tag_ids` string[]
  - `impressions` integer
  - `engagements_total` integer
  - `reactions_like` integer
  - `comments_count` integer
  - `shares_count` integer
  - `saves_count` integer
  - `engagement_rate` number
  - `analytics_last_sync` string, date-time
  - `analytics_last_sync_started_at` string, date-time
  - `social_inbox_last_sync` string, date-time
  - `social_inbox_last_sync_started_at` string, date-time
  - `video_thumbnail_uuid` string
  - `recur_interval` 'DAILY_SPECIFIC_TIME_SLOTS' | 'WEEKLY_SPECIFIC_TIME_SLOTS' | 'EVERY_3_HOURS' | 'EVERY_6_HOURS' | 'BI_DAILY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY': An enumeration.
  - `recur_interval_time_slots` string[]
  - `recur_interval_weekly_time_slots` string[]
  - `draft_approver_invited_emails` string[]
  - `draft_approval_status` object
  - `draft_approval_requested_by_user_id` string
  - `csv_post_import_process_id` string
  - `utm_source` string
  - `utm_medium` string
  - `utm_campaign` string
  - `utm_term` string
  - `utm_content` string
  - `media_ids` string[]
  - `shorturl_ids` string[]
  - `metadata` object
  - `ignore_credit_count` boolean
  - `first_comment` string
  - `add_first_comment` boolean
  - `x_reply_error` string
  - `x_reply_needs_review` boolean
  - `made_with_ai` boolean
  - `schedule_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `channel` object
  - `channels_for_form` object[]
  - `user` object
  - `draft_approval_requested_by_user` object
  - `automation` object
  - `post_tags` object[]

## Other responses

- `404`: Not found
- `422`: Validation Error

---

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