---
title: "Get available filter options for cases and earnings"
method: GET
path: "/referral-partner/filter-options"
tags: ["FilterOptions"]
---

# Get available filter options for cases and earnings

`GET /referral-partner/filter-options`

## Request

- Base URL: `https://referral-api.debitura.com`
- URL: `https://referral-api.debitura.com/referral-partner/filter-options`
- Auth: API key in header `XApiKey`

Returns distinct filter options available for the authenticated referral partner's cases and earnings pages.

**Countries** — Distinct debtor countries from the referral partner's case history, sorted alphabetically.

**CarveoutPartners** — Collection partners from the referral partner's active JurisdictionPricingZone records (DateDeleted == null and DateDeactivated == null), sorted alphabetically.

Use the returned IDs as values for the CountryIds and CollectionPartnerIds query parameters on the cases and reporting/transactions endpoints.

## Response `200`

Filter options retrieved successfully

- DebituraWebReferralPartnerApiModelsReferralPartnersGetFilterOptionsResponse: Response model for the filter-options endpoint, providing distinct filter values available for the authenticated referral partner's cases and earnings.
  - `countries` DebituraWebReferralPartnerApiModelsReferralPartnersFilterOptionCountry[], nullable: Distinct debtor countries from the referral partner's case history, sorted by name.
    - `id` integer
    - `name` string, nullable
  - `carveoutPartners` DebituraWebReferralPartnerApiModelsReferralPartnersFilterOptionCarveoutPartner[], nullable: Collection partners from the referral partner's active JurisdictionPricingZone records, sorted by name.
    - `id` string, uuid
    - `name` string, nullable

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/debitura/apis/debitura-referral-partner-api.md) - [All operations](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/revisions/cf12c7f270d9?raw)