---
title: "Search jurisdictions"
method: GET
path: "/v1/agent/jurisdictions/search"
tags: ["jurisdictions"]
---

# Search jurisdictions

`GET /v1/agent/jurisdictions/search`

## Request

- Base URL: `https://api.middesk.com`
- URL: `https://api.middesk.com/v1/agent/jurisdictions/search`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/middesk/apis/middesk-api/docs/v1/agent/jurisdictions/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search for jurisdictions by name, PSD code, or other criteria. Supports filtering by state, tax type, and jurisdiction type. Results are paginated.

## Query parameters

- `state` string
- `q` string
- `page` integer
- `per_page` integer
- `tax_type` string
- `local_only` string
- `slug` string

## Response `200`

jurisdictions search results

- JurisdictionsSearchJurisdictionsResponse
  - `object` string
  - `data` AgentJurisdiction[]
    - `object` string, required
    - `slug` string, required: Unique identifier for the jurisdiction
    - `type` string: Type of tax (e.g., City Tax, State Tax)
    - `label` string: Display label for the jurisdiction
    - `name` string, required: Full name of the jurisdiction
    - `agency_name` string: Name of the tax agency
    - `agency_slug` string: Unique identifier for the agency
    - `agency_items` string[]: List of items collected by the agency
    - `city` string, nullable: City name if applicable
    - `state` string, required: US state abbreviation
  - `url` string
  - `has_more` boolean
  - `total_count` integer

## Changes

- **2026-09-17** `4c9cd4e834ba`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `bearer_auth` was added to the API
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `searchJurisdictions` removed and replaced with `jurisdictions_searchJurisdictions`
- **2026-09-03** `ac0d9be94846`: 1 warning
  - deleted the `query` request parameter `supported_only`

[Operation history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/agent/jurisdictions/search/get.md)

---

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