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

# Get Statuses

> Retrieve statuses

Retrieve a list of statuses or get details for a specific status.

### Query Parameters

<ParamField query="id" type="string">
  Optional status ID to get a specific status
</ParamField>

<ParamField query="type" type="string" enum={["CANDIDATE", "JOB", "JOB_SUBMISSION"]}>
  Filter statuses by type
</ParamField>

### Response

<ResponseField name="statuses" type="array">
  List of status objects
</ResponseField>

<RequestExample>
  ```bash theme={null}
  # Get all candidate statuses
  curl --request GET \
    --url https://api.harmonyforstaffing.com/api/statuses?type=CANDIDATE \
    --header 'Authorization: Bearer <token>'

  # Get specific status
  curl --request GET \
    --url https://api.harmonyforstaffing.com/api/statuses?id=123 \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "statuses": [
      {
        "id": 123,
        "name": "In Review",
        "type": "CANDIDATE",
        "description": "Candidate is being reviewed by the hiring team",
        "isDefault": false,
        "isActive": true,
        "dateAdded": 1679253000
      }
    ]
  }
  ```
</ResponseExample>