# /organizations - Get available organizations

**GET /organizations**

Paginated list of organizations across the caller's hierarchy
(distributors + resellers + customers). Supports text search and
per-field filters; intended for filter dropdowns and assignment
pickers.

For callers with the Owner organization role, the first page is
prefixed with a synthetic entry for the Owner organization itself
(type "owner", empty database id): it exists only in Logto and is
the organization where Staff/Owner users are created. The entry
respects the active search/type filters and is excluded by
created_by or description filters.



## Servers
- Backend API server: https://my.nethesis.it/backend/api (Backend API server)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters

- **page** (integer)
  Page number

- **page_size** (integer)
  Items per page

- **search** (string)
  Search term. For organizations (distributors, resellers, customers), searches across name, description, and all custom_data fields (vat, address, city, contact, email, phone, language, notes, etc.). For systems, also searches across ipv4_address and ipv6_address.

- **sort_by** (string)
  Field to sort organizations by

- **sort_direction** (string)
  Sort direction

- **name** (string)
  Filter by organization name (exact match)

- **description** (string)
  Filter by organization description (exact match)

- **type** (array[string])
  Filter by organization type (repeatable; multiple values are OR-ed)

- **created_by** (string)
  Filter by creator user ID



## Responses
### 200
Organizations retrieved successfully

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)