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

# List Dispositions

> Returns all call dispositions available in your workspace.

# List Dispositions

Returns all call dispositions for your company: built-in dispositions first (`is_custom=false`), then custom dispositions (`is_custom=true`). Custom dispositions have a value prefixed with `custom_` and include label\_en, label\_fr, and a category.

## Request

`GET /v1/dispositions`

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/dispositions" \
    -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://kdjmltmhxvvmiuehafgl.supabase.co/functions/v1/api-gateway/v1/dispositions",
    {
      headers: {
        "Authorization": "Bearer rchd_live_xxxxxxxxxxxx"
      }
    }
  );
  const { data, meta } = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "data": [
    {
      "value": "appointment-scheduled",
      "label": "Appointment Scheduled",
      "label_en": "Appointment Scheduled",
      "label_fr": "Rendez-vous pris",
      "is_custom": false,
      "category": "reached"
    },
    {
      "value": "no-answer",
      "label": "No Answer",
      "label_en": "No Answer",
      "label_fr": "Pas de reponse",
      "is_custom": false,
      "category": "attempted"
    },
    {
      "value": "custom_a1b2c3d4",
      "label": "Pitch completed",
      "label_en": "Pitch completed",
      "label_fr": "Pitch termine",
      "is_custom": true,
      "category": "reached"
    }
  ],
  "meta": {
    "total": 3
  }
}
```

### Response Fields

| Field       | Type    | Description                                                                                                                               |
| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `value`     | string  | Disposition value (use this in API filters and call log responses)                                                                        |
| `label`     | string  | Display label (defaults to English)                                                                                                       |
| `label_en`  | string  | English label                                                                                                                             |
| `label_fr`  | string  | French label                                                                                                                              |
| `is_custom` | boolean | Whether this is a custom disposition created in your workspace                                                                            |
| `category`  | string  | Disposition category: `reached` (contact was reached), `attempted` (call attempted but no conversation), or `negative` (negative outcome) |

<Note>
  Built-in disposition values use kebab-case (e.g. `appointment-scheduled`, `no-answer`, `voicemail-left`). Custom dispositions have values prefixed with `custom_` (e.g. `custom_a1b2c3d4`). Use the `value` field when filtering call logs by disposition via the `disposition` query parameter on `GET /v1/call-logs`.
</Note>

### Disposition Values

| Disposition                | Category      | Description                                      |
| -------------------------- | ------------- | ------------------------------------------------ |
| `appointment-scheduled`    | Reached       | Meeting or demo scheduled                        |
| `not-interested`           | Reached       | Lead not interested                              |
| `send-email`               | Reached       | Send an email                                    |
| `callback-later`           | Reached       | Callback the lead later                          |
| `voicemail`                | Attempted     | Reached voicemail (no message left)              |
| `voicemail-left`           | Attempted     | Voicemail message left                           |
| `no-answer`                | Attempted     | No one answered                                  |
| `wrong-number`             | Reached       | Wrong number                                     |
| `personal-number`          | Reached       | Lead personal number                             |
| `wrong-person`             | Reached       | Wrong contact                                    |
| `no-longer-at-company`     | Reached       | Contact left the company                         |
| `abandoned-call`           | Attempted     | Call abandoned                                   |
| `voice-assistant-filtered` | Attempted     | Filtered by voice assistant                      |
| `voicemail-avoided`        | Attempted     | Voicemail detected, call ended before connecting |
| `not-specified`            | Not specified | Not specified                                    |

<Note>
  Custom dispositions created in your workspace have values prefixed with `custom_` (e.g. `custom_a1b2c3d4`). Use the <a href="/rest-api/dispositions/list-dispositions">List Dispositions</a> endpoint to retrieve all available dispositions including custom ones.
</Note>