> ## 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

```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();
```

## 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`.

### 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 [List Dispositions](https://docs.reachedapp.com/rest-api/dispositions/list-dispositions) endpoint to retrieve all available dispositions including custom ones.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.