---
title: "List statuses"
method: GET
path: "/v2/{target}/{identifier}/attributes/{attribute}/statuses"
tags: ["Attributes"]
---

# List statuses

`GET /v2/{target}/{identifier}/attributes/{attribute}/statuses`

Lists all statuses for a particular status attribute on either an object or a list.

When `target` is `objects`, the required scopes are `object_configuration:read`. When `target` is `lists`, the required scopes are `list_configuration:read`.

## Path parameters

- `target` 'lists' | 'objects', required — Whether the attribute is on an object or a list.
- `identifier` string, required — A UUID or slug to identify the object or list the status attribute belongs to.
- `attribute` string, required — A UUID or slug to identify the attribute you want to list statuses on.

## Query parameters

- `show_archived` boolean — `true` if you want the results to include archived statuses. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving.

## Response `200`

Success

- object — Success
  - `data` Status[], required
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace
      - `object_id` string, uuid, required — The ID of the object
      - `attribute_id` string, uuid, required — The ID of the attribute
      - `status_id` string, uuid, required — The ID of the status
    - `title` string, required — The title of the status
    - `is_archived` boolean, required — Whether or not to archive the status. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving.
    - `celebration_enabled` boolean, required — Whether arriving at this status triggers a celebration effect in the UI
    - `target_time_in_status` string, nullable, required — Target time for a record to spend in given status expressed as a ISO-8601 duration string

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/attio/apis/attio-api.md) · [All operations](https://skmtc.net/attio/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attio/attio-api/versions/40a8e41d06a2/schema)