---
title: "List Chains"
method: GET
path: "/api/chains"
tags: ["Chains"]
---

# List Chains

`GET /api/chains`

## Request

- Base URL: `https://data.getplace.io` (the document declares no server; this is the origin it was published from)
- URL: `https://data.getplace.io/api/chains`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`

List chains from pois_chain table with optional country and search filters.

Returns top chains by POI count (max 100). Use search parameter to find specific chains.
If user has chain_ids restrictions, only returns those chains.

## Query parameters

- `country_code` string, nullable
- `has_menu` boolean, nullable
- `search` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ChainResponse[]
  - `id` integer, required
  - `name` string, required
  - `country_code` string, nullable
  - `country_name` string, nullable
  - `poi_count` integer, required

## Other responses

- `422`: Validation Error

---

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