Skip to main content
GET
/
posts
List posts for a project
curl --request GET \
  --url https://api.scripe.io/v1/posts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "post_a1b2c3d4e5f6g7h8",
      "status": "<string>",
      "platform": "<string>",
      "contentType": "<string>",
      "title": "<string>",
      "content": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "projectId": "<string>",
      "scheduledAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "next_cursor": "<string>",
    "has_more": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidocs.scripe.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer scripe_sk_live_<...> (or scripe_sk_test_<...> for test keys) on every request. Keys are scoped to a single workspace and can be revoked from the Scripe dashboard.

Headers

​
Scripe-Api-Version
string

Pin the API version. Format YYYY-MM-DD. Omit to receive the currently rolling default. Unknown versions return 400 version_unsupported.

Example:

"2026-08-01"

Query Parameters

​
projectId
string
required
Example:

"proj_a1b2c3d4e5f6g7h8"

​
status
string

Comma-separated list of statuses to include. Valid values: waitingProcessing, draft, waitingApproval, approved, rejected, published, scheduled, suggested. Repeating the query key (?status=draft&status=published) also works.

Example:

"draft,scheduled"

​
dateFrom
string<date-time>

ISO 8601 or YYYY-MM-DD lower bound (inclusive).

​
dateTo
string<date-time>

ISO 8601 or YYYY-MM-DD upper bound (inclusive).

​
cursor
string

Opaque pagination cursor returned by the previous page.

​
limit
integer
default:50

Page size. Default 50, max 200.

Required range: 1 <= x <= 200

Response

Page of posts.

​
data
object[]
required
​
pagination
object
required