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

# List companies

`GET /companies`

Lists companies available to the authenticated API key.

## Response `200`

Companies returned

- object
  - `success` boolean
  - `companies` Company[]
    - `id` string
    - `name` string
    - `description` string, nullable
    - `status` string
    - `websiteUrl` string, nullable
    - `logoUrl` string, nullable
    - `founderName` string, nullable
    - `primaryColor` string, nullable
    - `brandColors` object, nullable
    - `valueProps` object[], nullable
    - `testimonials` object[], nullable
    - `toneVoice` string, nullable
    - `companyContext` string, nullable
    - `emailLengthPreference` 'concise' | 'balanced' | 'detailed' — How long AI-written email copy should be. New workspaces default to `concise`.
    - `socialLinks` object, nullable
    - `privacyPolicyUrl` string, nullable
    - `termsUrl` string, nullable
    - `address` string, nullable
    - `createdAt` string, date-time
    - `url` string, uri — Dashboard edit URL for this campaign.
    - `previewUrl` string, uri — Dashboard review/preview URL for this campaign.
    - `language` string
    - `pricing` object, nullable
    - `fontFamily` string, nullable
    - `emailTheme` object, nullable
    - `emailDirection` string
    - `emailLocalizationConfig` object
    - `defaultSenderProfileId` string, nullable
    - `defaultFromName` string, nullable
    - `defaultFromEmail` string, email, nullable
    - `defaultReplyProfileId` string, nullable
    - `defaultReplyToName` string, nullable
    - `defaultReplyToEmail` string, email, nullable
    - `replyTrackingEnabled` boolean — Whether inbound reply capture is enabled for this company.
    - `replyTrackingDomainMode` 'sequenzy' | 'custom' — Whether reply capture uses Sequenzy's managed inbound domain or a configured custom domain.
    - `forwardReplies` boolean — Whether captured replies are forwarded to the configured mailbox.
    - `replyRetentionDays` integer — Current reply retention period in days.
  - `currentCompanyId` string, nullable

## Other responses

- `401` — Unauthorized

## Changes

- **2026-08-02** `36f92fc0caa2` — 1 breaking, 3 warning
  - the response property `success` became optional for the status `401`
  - added the new `balanced` enum value to the `companies/items/emailLengthPreference` response property for the response status `200`
  - added the new `concise` enum value to the `companies/items/emailLengthPreference` response property for the response status `200`
  - added the new `detailed` enum value to the `companies/items/emailLengthPreference` response property for the response status `200`
- **2026-07-16** `ad2202945c5b` — 4 info
  - added the optional property `companies/items/forwardReplies` to the response with the `200` status
  - added the optional property `companies/items/replyRetentionDays` to the response with the `200` status
  - added the optional property `companies/items/replyTrackingDomainMode` to the response with the `200` status
  - added the optional property `companies/items/replyTrackingEnabled` to the response with the `200` status
- **2026-07-12** `d103f2b71fca` — 6 info
  - added the optional property `companies/items/defaultFromEmail` to the response with the `200` status
  - added the optional property `companies/items/defaultFromName` to the response with the `200` status
  - added the optional property `companies/items/defaultReplyProfileId` to the response with the `200` status
  - added the optional property `companies/items/defaultReplyToEmail` to the response with the `200` status
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/companies/get.md)

---

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