---
title: "List the task statuses on the SD Elements instance"
method: POST
path: "/api/v2/securityCompass/listTaskStatuses"
tags: ["Security Compass"]
---

# List the task statuses on the SD Elements instance

`POST /api/v2/securityCompass/listTaskStatuses`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/securityCompass/listTaskStatuses`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Read every task status defined on the organization's SD Elements instance — the built-in Complete / Incomplete / Not Applicable plus any custom statuses — with its slug and meaning. Use the slugs whose meaning is DONE or TODO as values in a task status mapping (securityCompass.updateProjectMapping); NA statuses are never accepted as targets. Uses the dashboard-saved credentials; fails with 400 when the instance cannot be reached.

## Request body

- SecurityCompassListTaskStatusesRequest
  - `organizationId` string, required: Organization that owns the integration.

## Response `200`

The task statuses defined on the instance

- SecurityCompassListTaskStatusesResponse
  - `statuses` SecurityCompassTaskStatus[], required: Every task status on the instance, built-in and custom.
    - `id` string, required: SD Elements status id, e.g. TS1.
    - `slug` string, required: Stable slug used as a value in SecurityCompassTaskStatusMapping, e.g. DONE.
    - `name` string, required: Display name, e.g. Complete.
    - `meaning` 'DONE' | 'TODO' | 'NA', required: What the status means to SD Elements. Only DONE and TODO statuses can be mapping targets; NA (Not Applicable) statuses are listed for display but never accepted.

## Other responses

- `400`: Error Response
- `401`: Error Response
- `404`: Error Response
- `409`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)