---
title: "List counties by country"
method: GET
path: "/county/lists-by-country"
tags: ["County"]
---

# List counties by country

`GET /county/lists-by-country`

Use this BillingServ API endpoint to list counties for a selected country. Cache the returned canonical county names and IDs for selection, or use search for autocomplete. Pass the selected county ID to the customer endpoint. Review the response for the operation result or validation errors.

## Query parameters

- `country_id` integer, required
- `page` integer
- `per_page` integer
- `search` string

## Response `200`

OK

- ApiResponse
  - `success` boolean

## Other responses

- `401` — Missing or invalid API key
- `403` — Authenticated key does not have permission for this endpoint
- `422` — Validation error

---

[API](https://skmtc.net/b-cdn/apis/billingserv-api-v2.md) · [All operations](https://skmtc.net/b-cdn/apis/billingserv-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b-cdn/billingserv-api-v2/revisions/76cfbed5eb40/schema)