---
title: "List Sectors"
method: GET
path: "/api/sectors/"
tags: ["sectors"]
---

# List Sectors

`GET /api/sectors/`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/sectors/`
- Auth: HTTP bearer

List sectors with optional filters.

Args:
    father_sector_uuid: Optional filter to list only subsectors of a specific sector.
                       If not provided, lists all sectors (root sectors and subsectors).
    include_deleted: Whether to include soft-deleted sectors in the results.
    only_names: Whether to return uuid, name, and father_sector_uuid (without relationships).

Returns:
    Paginated list of Sector instances

## Query parameters

- `father_sector_uuid` string, uuid, nullable: Filter by father sector UUID (list subsectors of a specific sector)
- `include_deleted` boolean: Include soft-deleted sectors in the results
- `only_names` boolean: When true, returns uuid, name, and father_sector_uuid for each sector (without relationships)
- `page` integer: Page number
- `size` integer: Page size

## Response `200`

Successful Response

- PageUnionSectorSectorRef
  - `items` union[], required
    - union
      - Sector: Full sector schema with relationships
        - `name` string, required
        - `info` object, nullable
        - `uuid` string, uuid4, required
        - `father_sector_uuid` string, uuid4, nullable
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `deleted_at` string, date-time, nullable
        - `subsectors` SectorRef[]
          - `uuid` string, uuid4, required
          - `name` string, required
          - `father_sector_uuid` string, uuid4, nullable
        - `contents` AppViewsSchemasSectorsSchemaContentRef[], required
          - `uuid` string, uuid4, required
          - `name` string, required
        - `organizations` OrganizationRef[], required
          - `uuid` string, uuid4, required
          - `name` string, required
      - SectorRef: Reference to a sector (for nested relationships and lightweight lists).
        - `uuid` string, uuid4, required
        - `name` string, required
        - `father_sector_uuid` string, uuid4, nullable
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)