# /distributors - List distributors

**GET /distributors**

Get paginated list of distributors (Owner only)


## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))


## 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 distributors by
- **sort_direction** (string)
  Sort direction
- **status** (array[string])
  Filter organizations by status. Supports multiple values.

  - enabled: not suspended and not deleted
  - suspended: suspended but not deleted
  - deleted: soft-deleted

  When "deleted" is combined with other statuses, both deleted and non-deleted matching records are returned.


## Responses
### 200
Distributors 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)


### 403
Forbidden - insufficient permissions

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

- **message** (string)

- **data** (object | null)



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