# List all post statuses

Returns all post statuses for the authenticated organization.

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.

Endpoint: GET /v2/post_statuses
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "post_status"

  - `id` (string, required)
    Unique identifier
    Example: "507f1f77bcf86cd799439011"

  - `name` (string, required)
    Display name
    Example: "In Progress"

  - `color` (string, required)
    Color for UI display
    Example: "Blue"

  - `type` (string, required)
    The workflow stage this status represents
    Enum: "reviewing", "unstarted", "active", "completed", "canceled"

  - `isDefault` (boolean, required)
    Whether this is the default status for new posts

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id", "invalid_parameter", "missing_parameter", "invalid_cursor", "invalid_content", "invalid_request", "contact_not_customer", "contact_not_attached", "parameter_not_supported"

  - `error.message` (string, required)
    Example: "Invalid post ID format"

  - `error.param` (string)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

  - `error.details` (array)
    Additional validation error details

  - `error.details.path` (string, required)
    Example: "body.name"

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "resource_not_found", "post_not_found", "comment_not_found", "changelog_not_found", "admin_not_found", "contact_not_found", "conversation_not_found", "conversation_part_not_found", "team_not_found", "survey_not_found", "company_not_found", "help_center_not_found", "collection_not_found", "article_not_found", "custom_field_not_found", "board_not_found", "voter_not_found", "participant_not_found", "webhook_not_found", "version_not_supported"

  - `error.message` (string, required)
    Example: "Post not found"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404

## Response 500 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "api_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "database_error", "internal_error", "fetch_error", "create_error", "update_error", "delete_error"

  - `error.message` (string, required)
    Example: "An internal error occurred"

  - `error.status` (number, required)
    HTTP status code
    Enum: 500