API Reference
List Scheduled Posts
List scheduled posts for the authenticated user, optionally filtered by a time range.
GET/scheduled-posts
Authenticate with a Bearer
sv_ token. The API scopes results to your user automatically—you do not pass userId as a developer. See Authentication.Query parameters
Full URL: https://shareviral-server-production.up.railway.app/api/v1/developer/scheduled-posts
| Parameter | Type | Description |
|---|---|---|
fromoptional | string (ISO 8601) | Inclusive lower bound on scheduled_for_ms. |
tooptional | string (ISO 8601) | Exclusive upper bound on scheduled_for_ms. |
Examples
cURL
curl "https://shareviral-server-production.up.railway.app/api/v1/developer/scheduled-posts?from=2026-07-01T00:00:00.000Z&to=2026-08-01T00:00:00.000Z" \
-H "Authorization: Bearer sv_your_api_token"Response
Posts are ordered by scheduled_for_ms ascending.
200 OK
{
"success": true,
"data": [
{
"id": "abc123…",
"post_text": "Launch week is live — join the waitlist.",
"post_type": "text",
"status": "scheduled",
"scheduled_for_iso": "2026-07-20T15:00:00.000Z",
"scheduled_for_ms": 1784559600000
}
]
}