---
title: "Get company"
method: GET
path: "/companies/{companyId}"
tags: ["Companies"]
---

# Get company

`GET /companies/{companyId}`

Returns one company workspace that the authenticated key can access.

## Path parameters

- `companyId` string, required

## Response `200`

Company returned

- object
  - `success` boolean
  - `company` 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.
    - `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.

## Other responses

- `401` — Unauthorized
- `404` — Company not found
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-08-20** `99f9c58cab67` — 1 info
  - added the optional property `company/defaultSubscriberListIds` to the response with the `200` status
- **2026-08-19** `ba3a29c6eb33` — 3 info
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `retryable` to the response with the `404` 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` — 3 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `company/emailDesignPrompt` to the response with the `200` status
- **2026-08-02** `36f92fc0caa2` — 2 breaking, 3 warning
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `404`
  - added the new `balanced` enum value to the `company/emailLengthPreference` response property for the response status `200`
  - added the new `concise` enum value to the `company/emailLengthPreference` response property for the response status `200`
  - …1 more

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/companies/:companyId/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/73f826277d9a/schema)