List the caller's scheduled Instagram posts (pending, processing, posted, failed, or canceled).
Lists all posts currently queued for scheduled publishing to Instagram on this account — across every status (pending, processing, posted, failed, canceled). Sorted by scheduled_for ascending.
Posts are created by passing scheduled_for to the Instagram publish endpoint instead of publishing immediately.
GET https://eranol.com/api/v1/social/instagram/scheduled-posts
| Field | Type | Notes |
|---|---|---|
id | string | The scheduled post's id — pass this to the cancel endpoint |
platform | string | Always "instagram" for this endpoint |
payload | object | The original publish request body for this post |
scheduled_for | string | ISO timestamp of when the post is/was due to publish |
status | string | pending, processing, posted, failed, or canceled |
fail_reason | string | null | Present when status is failed |
result | object | null | Present when status is posted — the platform-specific publish result |
created_at | string | ISO timestamp of when the post was scheduled |
{
"scheduled_posts": [{
"id": "a1b2c3d4-...",
"platform": "instagram",
"payload": {
"media_type": "REEL",
"media_url": "https://www.eranol.com/uploads/video.mp4",
"caption": "Dropping next week 📅",
"share_to_feed": true
},
"scheduled_for": "2026-09-01T15:00:00.000Z",
"status": "pending",
"fail_reason": null,
"result": null,
"created_at": "2026-08-25T10:00:00.000Z"
}]
}
| Status | Meaning |
|---|---|
401 | Missing or invalid API key |
402 | Insufficient credits |
500 | Internal server error — try again or contact support |