---
title: "Returns available filter values for guest profiles"
method: GET
path: "/profiles/filters"
tags: ["Profiles"]
---

# Returns available filter values for guest profiles

`GET /profiles/filters`

## Request

- Base URL: `/guest-profiles/v1` (relative, and the document’s source URL is not known)
- URL: `/guest-profiles/v1/profiles/filters`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token` scopes: `read:guest`

Returns the list of countries and guest statuses that can be used as filter values
when querying guest profiles. Both countries and statuses are sourced from the
guest-profile service.

## Headers

- `X-Organization-Id` string, required

## Response `200`

Response

- ProfileFiltersResponse
  - `countries` FilterCountry[], required: List of countries found in guest profiles
    - `code` string, required: ISO 3166-1 alpha-2 country code
    - `name` string, required: Country name
  - `guestStatuses` FilterGuestStatus[], required: List of guest statuses available as filter values
    - `id` integer, required: Status ID
    - `name` string, required: Status name

## Other responses

- `404`: API not enabled
- `5XX`: An error occurred interacting with the API.

---

[API](https://skmtc.dev/cloudbeds/apis/guest-profile-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/guest-profile-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/guest-profile-api/revisions/df6e85914ec0?raw)