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

# Get ticket statuses

> MCP tool to retrieve all possible ticket statuses from the Thena platform, optionally filtered by team.

import Admonition from '@theme/Admonition';

### MCP tool: `get_ticket_statuses`

Retrieves all possible statuses for tickets in the Thena platform, optionally filtered by team. Useful for building status dropdowns, validating ticket state transitions, or analytics.

<Admonition type="note">
  If no <code>teamId</code> is provided, the tool returns all statuses available to the user.
</Admonition>

### Example prompt

```prompt theme={null}
Show me all ticket statuses for team T88WCYYHPS
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>get\_ticket\_statuses</code> tool with the correct arguments.
</Admonition>

#### Example prompt (all statuses, no teamId)

```prompt theme={null}
Show me all ticket statuses
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

### Input parameters

| Name   | Type   | Required | Description                              |
| ------ | ------ | -------- | ---------------------------------------- |
| teamId | string | No       | The team ID to fetch ticket statuses for |

### Response fields

Below are the fields you may see in a ticket status result:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr><td>id</td><td>string</td><td>Unique status ID</td></tr>
    <tr><td>name</td><td>string</td><td>Status name (e.g., "Open")</td></tr>
    <tr><td>displayName</td><td>string</td><td>Display name for the status</td></tr>
    <tr><td>description</td><td>string</td><td>Description of the status</td></tr>
    <tr><td>isDefault</td><td>boolean</td><td>Whether this is the default status</td></tr>
    <tr><td>teamId</td><td>string</td><td>Team ID this status belongs to</td></tr>
    <tr><td>organizationId</td><td>string</td><td>Organization ID this status belongs to</td></tr>
    <tr><td>createdAt</td><td>string (ISO8601)</td><td>Creation timestamp</td></tr>
    <tr><td>updatedAt</td><td>string (ISO8601)</td><td>Last update timestamp</td></tr>
  </tbody>
</table>

Other top-level fields in the response:

| Field     | Type    | Description                               |
| --------- | ------- | ----------------------------------------- |
| data      | array   | List of ticket status objects             |
| status    | boolean | Whether the request was successful        |
| message   | string  | Status message                            |
| timestamp | string  | Time the response was generated (ISO8601) |

### Sample response

```json theme={null}
{
  "data": [
    {
      "id": "XKNKDHSJ1058098FSEG2NHBSD19BT",
      "name": "Open",
      "displayName": "Open",
      "description": "Tickets that are open and awaiting prioritization.",
      "isDefault": true,
      "teamId": "T88WCYYHPS",
      "organizationId": "EYYYXCC853",
      "createdAt": "2025-04-23T13:32:45.551Z",
      "updatedAt": "2025-04-23T13:32:45.551Z"
    },
    {
      "id": "XKNKDHSJ10YZXC0EMG11F7TQWZRQS",
      "name": "In progress",
      "displayName": "In progress",
      "description": "Tickets that are currently in progress and being worked on.",
      "isDefault": false,
      "teamId": "T88WCYYHPS",
      "organizationId": "EYYYXCC853",
      "createdAt": "2025-04-23T13:32:45.551Z",
      "updatedAt": "2025-04-23T13:32:45.551Z"
    },
    {
      "id": "XKNKDHSJ10MD9M1JQTKJGXFJK836Q",
      "name": "On hold",
      "displayName": "On hold",
      "description": "Tickets that are currently on hold.",
      "isDefault": false,
      "teamId": "T88WCYYHPS",
      "organizationId": "EYYYXCC853",
      "createdAt": "2025-04-23T13:32:45.551Z",
      "updatedAt": "2025-04-23T13:32:45.551Z"
    },
    {
      "id": "XKNKDHSJ10ZXBHEXAEPG2KZZSX8JN",
      "name": "Closed",
      "displayName": "Closed",
      "description": "Tickets that are closed or resolved.",
      "isDefault": false,
      "teamId": "T88WCYYHPS",
      "organizationId": "EYYYXCC853",
      "createdAt": "2025-04-23T13:32:45.551Z",
      "updatedAt": "2025-04-23T13:32:45.551Z"
    }
  ],
  "status": true,
  "message": "Ticket statuses fetched successfully!",
  "timestamp": "2025-07-24T07:13:55.252Z"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

***