---
title: "List region codes (cultural affinity)"
method: GET
path: "/api/v1/regions"
tags: ["Discovery"]
---

# List region codes (cultural affinity)

`GET /api/v1/regions`

## Request

- Base URL: `https://quizbase.runriva.com`
- URL: `https://quizbase.runriva.com/api/v1/regions`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Discovery dla `regions` filter. **Cultural affinity** — pytanie ma code regionu, jeśli mieszkańcy kraju lub członkowie grupy kulturowej/religijnej są statystycznie częściej w stanie odpowiedzieć (NIE geografia tematu pytania). Lowercase ISO 3166-1 alpha-2 (`us`, `pl`, `gb`) + cultural codes (`jewish`, `christian-catholic`, `islam` — LLM schema whitelist parity). Sourced from a pre-aggregated table. Cardinality ~150 distinct codes per language.

## Query parameters

- `lang` 'en' | 'pl': Display language for category names + slug labels (subcategories/tags)
- `q` string
- `kind` 'country' | 'cultural'
- `cursor` string
- `limit` integer

## Response `200`

Region codes with labels, kind classification, counts.

- RegionsListResponse
  - `data` RegionEntry[], required
    - `code` string, required
    - `kind` 'country' | 'cultural', required
    - `label` string, required
    - `count` integer, required
  - `meta` MetaRegionsList, required
    - `count` integer, required
    - `total` integer, required
    - `language` string, required: Language of the response content.
    - `requestId` string, uuid, required: Unique request identifier (also in `X-Request-Id` response header).
  - `_links` Links
    - `next` string: URL to the next page.
    - `prev` string: URL to the previous page.

## Other responses

- `401`: Missing, malformed, invalid, or revoked API key.
- `403`: IP not allowed (per-key allowlist).
- `429`: Rate limit exceeded. See `Retry-After` header.
- `500`: Server error.

---

[API](https://skmtc.dev/runriva/apis/quizbase-api.md) · [All operations](https://skmtc.dev/runriva/apis/quizbase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runriva/apis/quizbase-api/revisions/4c2f9be78ec9?raw)