> ## Documentation Index
> Fetch the complete documentation index at: https://developer.dittowords.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch statuses

> Returns the statuses which text items and library components in the workspace can be set to, in workflow order — from earliest (a first draft) to latest (ready to ship). A workspace can rename the default statuses or replace the set entirely, so none of the defaults are guaranteed to exist. Read the available statuses here before setting a status or filtering by one rather than assuming any particular key is valid.



## OpenAPI

````yaml openapi.json get /statuses
openapi: 3.0.0
info:
  version: 1.0.0
  title: Ditto API
  description: Programmatically read and write data in your Ditto workspace.
servers:
  - url: https://api.dittowords.com/v2
security: []
paths:
  /statuses:
    get:
      tags:
        - Statuses
      summary: Fetch statuses
      description: >-
        Returns the statuses which text items and library components in the
        workspace can be set to, in workflow order — from earliest (a first
        draft) to latest (ready to ship). A workspace can rename the default
        statuses or replace the set entirely, so none of the defaults are
        guaranteed to exist. Read the available statuses here before setting a
        status or filtering by one rather than assuming any particular key is
        valid.
      responses:
        '200':
          description: Returns an array of statuses in the workspace, in workflow order
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: >-
                        The status's stable identifier. This is the value to
                        send when setting the `status` field on a text item or
                        library component, and when querying with a `statuses`
                        filter — never the display name
                    name:
                      type: string
                      description: >-
                        The status's display name, for use anywhere the status
                        is shown to a person — as it appears in the web app and
                        Figma plugin. Not accepted as an identifier when setting
                        or filtering by status
                  required:
                    - id
                    - name
                example:
                  - id: NONE
                    name: Draft
                  - id: WIP
                    name: In Progress
                  - id: REVIEW
                    name: In Review
                  - id: FINAL
                    name: Final
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````