---
title: "List countries"
method: GET
path: "/country/lists"
tags: ["Country"]
---

# List countries

`GET /country/lists`

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

## Query parameters

- `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)