> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ask-wire.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List regional units

> Returns a paginated list of regional units (level 4 in the geographic hierarchy).

## Overview

Regional units sit at level 4 in the Ask Wire geographic hierarchy: region (3) → **regional unit (4)** → municipality (5) → municipal unit (6) → neighborhood.

Use this endpoint to discover regional unit IDs for filtering the [List properties](/api-reference/endpoint/get) endpoint via the `regional_unit` parameter.

***

## Query parameters

### Pagination

| Parameter   | Type    | Description                           |
| ----------- | ------- | ------------------------------------- |
| `page`      | integer | Page number within the result set.    |
| `page_size` | integer | Number of results to return per page. |

***

### Filters

| Parameter     | Type     | Description                                              |
| ------------- | -------- | -------------------------------------------------------- |
| `code`        | string   | Filter by the regional unit's short code.                |
| `country`     | string   | Filter by country. Available values: `greece`, `cyprus`. |
| `level`       | integer  | Filter by hierarchy level.                               |
| `name_en`     | string   | Filter by English name.                                  |
| `name_gr`     | string   | Filter by Greek name.                                    |
| `parent_code` | array    | Filter by parent code. Multiple values comma-separated.  |
| `parent_id`   | integer  | Filter by parent geographic unit ID.                     |
| `created_at`  | datetime | Filter by creation date (ISO 8601).                      |
| `modified_at` | datetime | Filter by last modified date (ISO 8601).                 |

***

## Response fields

### Pagination wrapper

| Field      | Type           | Description                                      |
| ---------- | -------------- | ------------------------------------------------ |
| `count`    | integer        | Total number of results across all pages.        |
| `next`     | string \| null | URL of the next page, or `null` if on last page. |
| `previous` | string \| null | URL of the previous page, or `null` if on first. |
| `results`  | array          | Array of regional unit objects.                  |

***

### Regional unit object

| Field         | Type     | Description                                               |
| ------------- | -------- | --------------------------------------------------------- |
| `id`          | integer  | Unique ID.                                                |
| `name_en`     | string   | Name in English.                                          |
| `name_gr`     | string   | Name in Greek.                                            |
| `code`        | string   | Short code for this regional unit.                        |
| `parent_code` | string   | Code of the parent region.                                |
| `parent_id`   | integer  | ID of the parent region.                                  |
| `level`       | integer  | Level in the geographic hierarchy (4 for regional units). |
| `country`     | string   | Country this unit belongs to (e.g. `greece`, `cyprus`).   |
| `created_at`  | datetime | When this record was created.                             |
| `modified_at` | datetime | When this record was last modified.                       |


## OpenAPI

````yaml GET /api/regional-units/
openapi: 3.1.0
info:
  title: Properties API
  version: 1.0.0
  description: Public properties and foreclosure listings API
servers:
  - url: https://pandora.ask-wire.com
    description: Main API (Properties)
  - url: https://zeus.ask-wire.com
    description: Auth API
security:
  - bearerAuth: []
paths:
  /api/regional-units/:
    get:
      summary: List regional units
      description: >-
        Returns a paginated list of regional units (level 4 in the geographic
        hierarchy).
      operationId: listRegionalUnits
      parameters:
        - name: page
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: code
          in: query
          schema:
            type: string
        - name: country
          in: query
          schema:
            type: string
            enum:
              - greece
              - cyprus
        - name: level
          in: query
          schema:
            type: integer
        - name: name_en
          in: query
          schema:
            type: string
        - name: name_gr
          in: query
          schema:
            type: string
        - name: parent_code
          in: query
          description: Multiple values may be separated by commas.
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
        - name: parent_id
          in: query
          schema:
            type: integer
        - name: created_at
          in: query
          schema:
            type: string
            format: date-time
        - name: modified_at
          in: query
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Paginated regional unit results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedGeoEntityResponse'
              example:
                count: 123
                next: http://api.example.org/accounts/?page=4
                previous: http://api.example.org/accounts/?page=2
                results:
                  - id: 0
                    created_at: '2026-05-26T14:37:13.574Z'
                    modified_at: '2026-05-26T14:37:13.574Z'
                    country: greece
                    parent_id: 2147483647
                    name_gr: string
                    name_en: string
                    level: 2147483647
                    code: string
                    parent_code: string
components:
  schemas:
    PaginatedGeoEntityResponse:
      type: object
      properties:
        count:
          type: integer
        next:
          type:
            - string
            - 'null'
          format: uri
        previous:
          type:
            - string
            - 'null'
          format: uri
        results:
          type: array
          items:
            $ref: '#/components/schemas/GeoEntity'
    GeoEntity:
      type: object
      properties:
        id:
          type: integer
        created_at:
          type: string
          format: date-time
        modified_at:
          type: string
          format: date-time
        country:
          type: string
        parent_id:
          type: integer
        name_gr:
          type: string
        name_en:
          type: string
        level:
          type: integer
        code:
          type: string
        parent_code:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

## Related topics

- [List properties](/docs/api-reference/endpoint/get.md)
- [List municipalities](/docs/api-reference/endpoint/municipalities.md)
- [Retrieve a property](/docs/api-reference/endpoint/get-by-id.md)
- [Retrieve a property by reference ID](/docs/api-reference/endpoint/get-by-reference-id.md)