---
title: "List companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# List companies

`GET /companies`

## Request

- Base URL: `https://api.modem.dev/v1`
- URL: `https://api.modem.dev/v1/companies`
- Auth: HTTP bearer

List companies with aggregated statistics across all associated persons

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `sortBy` 'lastSeen' | 'messageCount' | 'personCount'
- `sortOrder` 'asc' | 'desc'

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string, required
    - `isOrgCompany` boolean, required
    - `isVip` boolean, required
    - `lastSeenAt` string, date-time, nullable
    - `logoUrl` string, uri, nullable, required: Company logo image URL.
    - `messageCount` integer, required
    - `name` string, required: Company name.
    - `personCount` integer, required
    - `primaryDomain` string, nullable, required
  - `limit` integer, required: The page size used for this response.
  - `page` integer, required: The 1-based page number returned.
  - `totalCount` integer, required: Total number of items matching the query, across all pages.

## Other responses

- `400`: Invalid request (validation failed).
- `401`: Missing or invalid API key.
- `403`: The API key does not have access to this resource.
- `404`: The requested resource was not found.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

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