---
title: "Available advanced filter values"
method: GET
path: "/locations/advanced-search-filters"
tags: ["Locations"]
---

# Available advanced filter values

`GET /locations/advanced-search-filters`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/advanced-search-filters`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/advanced-search-filters/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the distinct values available for the advanced location filters across the account's locations: countries, states, cities, postal (zip) codes, and custom attribute names. Use these values to populate the advanced filter controls before calling Filter locations.

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Response `200`

Successful response

- object
  - `data` object
    - `advancedSearchFilters` LocationAdvancedSearchFilterType
      - `country` object[]: Countries present across the account's locations.
      - `state` object[]: States present across the account's locations.
      - `city` string[]
      - `zipcode` string[]
      - `customAttrs` string[]: Custom attribute names defined for the account.

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

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