---
title: "Get Filter Options"
method: GET
path: "/calls/filter-options"
tags: ["calls"]
---

# Get Filter Options

`GET /calls/filter-options`

## Request

- Base URL: `https://dev.whispa.net` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.whispa.net/calls/filter-options`
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `auth/bearer/login`
  - API key in cookie `access_token`

Get available filter options for call history.

Returns distinct values for scenarios, agents, statuses, modes, and sources.
Options follow the same agent/team/admin visibility scope as the call list.

## Query parameters

- `team_id` string, uuid, nullable: Team filter; team leads are fixed to their assigned team

## Response `200`

Successful Response

- CallFilterOptionsResponse: Available filter options for call history.
  - `scenarios` FilterOption[]: Available scenario options
    - `label` string, required
    - `value` string, required
  - `agents` FilterOption[]: Available agent options (user emails)
    - `label` string, required
    - `value` string, required
  - `statuses` FilterOption[]: Available status options
    - `label` string, required
    - `value` string, required
  - `modes` FilterOption[]: Available call mode options
    - `label` string, required
    - `value` string, required
  - `sources` FilterOption[]: Available call source options
    - `label` string, required
    - `value` string, required
  - `directions` FilterOption[]: Available call direction options
    - `label` string, required
    - `value` string, required
  - `feedback_ratings` FilterOption[]: Available coaching feedback rating options (positive, negative)
    - `label` string, required
    - `value` string, required
  - `telephony_results` FilterOption[]: Available telephony result options (connected, busy, no_answer, rejected, failed)
    - `label` string, required
    - `value` string, required
  - `answered_by_options` FilterOption[]: Available answered_by options (human, voicemail, unclear)
    - `label` string, required
    - `value` string, required
  - `conversation_outcomes` FilterOption[]: Available conversation outcome options (engaged, refused, wrong_person, other)
    - `label` string, required
    - `value` string, required
  - `idv_statuses` FilterOption[]: Available IDV status options (verified, partial, incomplete, not_required)
    - `label` string, required
    - `value` string, required
  - `workflow_dispositions` FilterOption[]: Available autonomous workflow disposition options
    - `label` string, required
    - `value` string, required
  - `agent_end_reasons` FilterOption[]: Available normalized autonomous call-ending reasons
    - `label` string, required
    - `value` string, required
  - `transfer_options` FilterOption[]: Available transfer filter options (transfer_in, transfer_out)
    - `label` string, required
    - `value` string, required
  - `dashboard_options` FilterOption[]: Available dashboard presence filter options (dashboard_open)
    - `label` string, required
    - `value` string, required
  - `crm_link_options` FilterOption[]: Available CRM account-link filter options
    - `label` string, required
    - `value` string, required
  - `client_options` FilterOption[]: Available classified client options
    - `label` string, required
    - `value` string, required
  - `client_classification_enabled` boolean: Whether any active scenario supports client classification

## Other responses

- `422`: Validation Error

---

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