Skip to main content
Post Statuses

List all post statuses

Returns all post statuses for the authenticated organization.

GET
/v2/post_statuses

Post statuses define workflow stages for posts. Each status has:

  • A display name and color
  • A type indicating the workflow stage (reviewing, unstarted, active, completed, canceled)
  • A flag indicating if it's the default status for new posts

This endpoint returns all post statuses without pagination. Organizations typically have a small number of statuses.

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

itemsobject[]