API reference
List posts with status scheduled, ordered by scheduled time.
https://api.betterpost.dev/v1/posts/scheduled| Name | Type | Default | Description |
|---|---|---|---|
limit | integer | 20 | 1 to 100. |
offset | integer | 0 | Posts to skip. |
sort | string | asc | asc (soonest first) or desc, by scheduledFor. |
curl -s "https://api.betterpost.dev/v1/posts/scheduled?limit=20" \
-H "x-access-key: $BETTERPOST_API_KEY"200 OK
{
"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"
}
]
}A scheduled retry appears here too; its already published targets show
status: "published".
| Status | Code | When |
|---|---|---|
200 | Success. | |
400 | validation_error | limit, offset or sort is invalid. |
401 | unauthorized | Missing or unknown API key. |
429 | rate_limited | More than 120 requests per minute. |