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

# Get Dispositions

> Returns all dispositions available for the team, including default and custom dispositions

Retrieves all dispositions available for your team. Dispositions are call outcome categories used to classify the result of each call.

This endpoint returns both default dispositions (built-in) and any custom dispositions your team has created.

### Query Parameters

* **is\_custom** (*optional*, boolean): Filter by custom or default dispositions
  * `true` - Only return custom dispositions
  * `false` - Only return default dispositions
* **category** (*optional*, string): Filter by disposition category
  * `positive` - Meeting set, referral, callback later, reach out in 6 months, send an email
  * `negative` - Not interested, do not call again
  * `neutral` - No longer with company, wrong contact
  * `not_answered` - No answer, left voicemail, gatekeeper, bad number
  * `cancelled` - Cancelled calls

### Response

Returns a JSON object containing an array of dispositions.

```json theme={null}
{
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "id": 1,
      "name": "Answered - Meeting Set",
      "is_custom": false,
      "is_required": true,
      "category": "positive"
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "id": 2,
      "name": "Answered - No Longer with Company",
      "is_custom": false,
      "is_required": false,
      "category": "neutral"
    }
  ]
}
```

### Response Fields

| Field         | Type    | Description                                  |
| ------------- | ------- | -------------------------------------------- |
| `_id`         | string  | Unique identifier                            |
| `id`          | number  | Disposition ID (use for filtering call logs) |
| `name`        | string  | Human-readable disposition name              |
| `is_custom`   | boolean | Whether this is a custom disposition         |
| `is_required` | boolean | Whether this disposition is required         |
| `category`    | string  | Disposition category                         |

### Default Dispositions

| ID | Name                              | Category      |
| -- | --------------------------------- | ------------- |
| 1  | Answered - Meeting Set            | positive      |
| 2  | Answered - No Longer with Company | neutral       |
| 3  | Answered - Not Interested         | negative      |
| 4  | Answered - Referral               | positive      |
| 5  | Answered - Wrong Contact          | neutral       |
| 6  | Answered - Call back later        | positive      |
| 7  | Answered - Reach out in 6 months  | positive      |
| 8  | Answered - Send an email          | positive      |
| 9  | Answered - Do not call again      | negative      |
| 10 | No Answer                         | not\_answered |
| 11 | Left Voicemail                    | not\_answered |
| 12 | Gatekeeper                        | not\_answered |
| 13 | Bad Number                        | not\_answered |
| 14 | Cancelled                         | cancelled     |


## OpenAPI

````yaml GET /v1/dispositions
openapi: 3.0.1
info:
  title: Salesfinity API
  description: API documentation for Salesfinity platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://client-api.salesfinity.co
security:
  - ApiKeyAuth: []
paths:
  /v1/dispositions:
    get:
      tags:
        - Dispositions
      description: >-
        Returns all dispositions available for the team, including default and
        custom dispositions
      operationId: get-dispositions
      parameters:
        - name: is_custom
          in: query
          required: false
          schema:
            type: boolean
          description: Filter by custom (true) or default (false) dispositions
        - name: category
          in: query
          required: false
          schema:
            type: string
            enum:
              - positive
              - negative
              - neutral
              - not_answered
              - cancelled
          description: Filter by disposition category
      responses:
        '200':
          description: Dispositions retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/DispositionDTO'
components:
  schemas:
    DispositionDTO:
      type: object
      properties:
        _id:
          type: string
          description: Unique identifier
        id:
          type: integer
          description: Disposition ID
        name:
          type: string
          description: Human-readable disposition name
        is_custom:
          type: boolean
          description: Whether this is a custom disposition
        is_required:
          type: boolean
          description: Whether this disposition is required
        category:
          type: string
          enum:
            - positive
            - negative
            - neutral
            - not_answered
            - cancelled
          description: Disposition category
      required:
        - _id
        - id
        - name
        - is_custom
        - category
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````