---
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
    - `emailDesignPrompt` string, nullable — Art direction for AI-designed emails: layout, density, which sections belong in an email, imagery, and CTA prominence. `toneVoice` steers copy; this steers design. When empty, the next email generation prefills it with the direction derived from the brand.
    - `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
    - `defaultSubscriberListIds` string[], nullable — Workspace default lists new contacts join when nothing targets them explicitly. null means every current and future list, [] means no list at all, and an array means exactly those lists.
    - `emailBranding` object — Effective "Sent with Sequenzy" entitlement for future renders and sends. This is derived from the company owner's subscription and is not an editable footer field. Existing live sequences pick up an entitlement change without their stored email blocks changing.
      - `visible` boolean, required — Whether Sequenzy branding is added to outgoing email.
      - `removalEntitled` boolean, required — Whether the current owner subscription removes branding.
      - `reason` 'free_plan' | 'paid_plan' | 'email_partner' | 'inactive_subscription' | 'company_not_found', required
      - `managedBy` 'owner_subscription', required
      - `removalAction` 'none' | 'upgrade' | 'renew_subscription', required
      - `subscriptionTier` 'free' | 'pro_1k' | 'pro_5k' | 'pro_10k' | 'pro_25k' | 'pro_30k' | 'pro_50k' | 'pro_100k' | 'pro_150k' | 'pro_2m' | 'pro_3m' | 'pro_4m' | 'pro_5m' | 'enterprise', nullable, required
      - `subscriptionStatus` 'active' | 'past_due' | 'canceled' | 'trialing' | 'incomplete', nullable, required
      - `subscriptionUrl` string, uri, required — Owner-facing subscription, upgrade, and billing-management page.
    - `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
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-08-31** `e1667306c303` — 1 info
  - added the optional property `companies/items/emailBranding` to the response with the `200` status
- **2026-08-20** `99f9c58cab67` — 1 info
  - added the optional property `companies/items/defaultSubscriberListIds` to the response with the `200` status
- **2026-08-19** `ba3a29c6eb33` — 2 info
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `retryable` to the response with the `503` status
- **2026-08-18** `8fbabe82a04d` — 1 info
  - added the non-success response with the status `503`
- **2026-08-16** `6fd2903b91ce` — 2 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `companies/items/emailDesignPrompt` to the response with the `200` status

[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/e1667306c303/schema)