List project statuses
GET/api/project-statuses
Required permissions:
- project_status.view: allows view resources of projects where the user is the PM or the Account.
- project_status.view_other: allows view resources of projects where the user is not the PM nor the Account.
Here the dedicated support page.
Request
Query Parameters
- On a date
- Greater than
- Lower than
- Exclude deleted
- Include deleted
- Only deleted
- On a date
- Greater than
- Lower than
Possible values: <= 100
Default value: 100
The number of items to include in the response.
Default value: 0
The offset of the first returned item.
Filter items by the updated_at field. This is in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
Filter items updated on a date.
Example: 2024-01-01T20:00:00%2B02:00
Filter items updated after a date.
Example: gt:2024-01-01T20:00:00%2B02:00
Filter items updated before a date.
Example: lt:2024-01-01T20:00:00%2B02:00
Possible values: [exclude, include, only]
Default value: exclude
Filter items by deletion status.
Exclude soft-deleted records.
Example: exclude
Include both active and soft-deleted records.
Example: include
Return only soft-deleted records.
Example: only
Filter items by the deleted_at field. This is in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
Filter items deleted on a date.
Example: 2024-01-01T20:00:00%2B02:00
Filter items deleted after a date.
Example: gt:2024-01-01T20:00:00%2B02:00
Filter items deleted before a date.
Example: lt:2024-01-01T20:00:00%2B02:00
The id of the project to filter the results on.
Header Parameters
The company you want to interact with
The API version you want to use
Responses
- 200
- 400
- 401
- 403
- 412
Returns the list of project statuses.
- application/json
- Schema
- Example (from schema)
Schema
- Array [ 
- ] 
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
Possible values: >= 1
ID of the project to which the project status belongs
The date of the project status
The amount of days left
The percentual progress
The project status notes
Possible values: >= 1
ID of the project status risk
The date and time when the resource was deleted
[
  {
    "id": 1,
    "created_at": "2025-10-28T10:23:50.053Z",
    "updated_at": "2025-10-28T10:23:50.053Z",
    "project_id": 1,
    "date": "2025-10-28",
    "days_left": 4.5,
    "progress": 10,
    "notes": "I am a note",
    "project_status_risk_id": 1,
    "deleted_at": "2025-10-28T10:23:50.053Z"
  }
]
Validation failed
- application/json
- Schema
- Example (from schema)
Schema
- Array [ 
- ] 
Error unique key
Human-readable message describing the error
failures
object[]
List of validation errors
Name of the field causing the error
Human-readable description of the error
{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "string",
  "message": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "string",
  "message": "string"
}
Precondition failed
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "precondition_failure",
  "message": "string"
}