Scheduling
See the posts waiting to publish, soonest first.
curl -s "https://api.betterpost.dev/v1/posts/scheduled?limit=20&offset=0&sort=asc" \
-H "x-access-key: $BETTERPOST_API_KEY"{
"success": true,
"total": 1,
"posts": [
{
"postId": "post_8f3k2m9q1x7v4n6b0c5d2a1z",
"content": "Doors open at 9",
"scheduledFor": "2026-11-03T14:00:00.000Z",
"timezone": "America/New_York",
"mediaItems": [],
"platforms": [
{ "platform": "twitter", "status": "pending" },
{ "platform": "linkedin", "status": "pending" }
],
"sandbox": true,
"createdAt": "2026-10-21T14:20:11.274Z"
}
]
}Only posts whose status is scheduled are listed, ordered by scheduledFor (sort=asc, the default, puts the
next one first). limit is 1 to 100 (default 20).
Reference: GET /v1/posts/scheduled.