---
title: "List companies for admins"
method: GET
path: "/api/admin/companies/"
tags: ["Administration/Companies"]
---

# List companies for admins

`GET /api/admin/companies/`

Paginated, filterable, sortable list of companies (admin only). Supports an `isDropDown` mode that returns every matching company without page slicing, and a `removed` filter to list soft-deleted companies instead of active ones.

## Query parameters

- `page` integer
- `count` integer
- `sort` string
- `filter` string
- `hasFeature` string
- `isDropDown` union
  - boolean
  - string
- `removed` union
  - boolean
  - string

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
    - `pagination` object
      - `page` number, required — Current page number (1-based).
      - `limit` number, required — Page size used for this response. Endpoint defaults vary — see each endpoint's limit parameter.
      - `total` number, required — Total number of records across all pages.
      - `totalPages` number, required — Total number of pages. Iterate until page reaches totalPages.
  - `data` object[], required
    - `id` string, required
    - `name` string, nullable
    - `officialName` string, nullable
    - `country` string, nullable
    - `city` string, nullable
    - `parentId` string, nullable
    - `parentDisplayName` string, nullable
    - `byCompanyId` string, nullable
    - `facilityProcesses` string, nullable
    - `activeUsersCount` union
      - number
      - string
    - `totalUsersCount` union
      - number
      - string
    - `isDemoCompany` number, nullable
    - `isClientCompany` number, nullable
    - `updatedAt` string, date-time, nullable
    - `featuredImageFileUrl` string, nullable

## Other responses

- `401` — Default Response
- `403` — Default Response

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/companies/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/97e51f27dc77/schema)