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

# Get a company

`GET /v1/partner/companies/{companyId}`

## Request

- Base URL: `https://api.test.doola.com`
- URL: `https://api.test.doola.com/v1/partner/companies/{companyId}`
- Auth: API key in header `Authorization`

Returns a single company by doola company ID, including formation status, EIN (once issued), members, addresses, and services.

## Path parameters

- `companyId` string, required

## Response `200`

OK

- PartnerCompanyResponse: A company, including formation progress and post-formation details.
  - `doolaCompanyId` string: doola company ID (KSUID).
  - `doolaCustomerId` string: Owning doola customer ID (KSUID).
  - `entityType` 'LLC' | 'CCorp': Entity type.
  - `state` string: State of formation.
  - `nameOptions` PartnerCompanyNameOptionDto[]
    - `id` string: Server-assigned ID.
    - `name` string, required: Proposed company name, without the entity ending.
    - `entityTypeEnding` string, required: Entity-type ending appended to the name.
    - `position` integer: Preference order, lowest first. Ignored on create, where array order sets the preference and responses return it starting at 0. On a name-options resolution, options are ordered by this value, or by array order when it is omitted.
  - `industry` string: Unique NAICS industry label the company was classified under.
  - `description` string
  - `responsibleParty` PartnerResponsiblePartyDto: The person legally responsible for the company (used for tax filings).
    - `id` string: Server-assigned ID.
    - `legalFirstName` string, required: Legal first name.
    - `legalLastName` string, required: Legal last name.
    - `ssn` string: Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data.
    - `email` string, required: Contact email.
    - `address` PartnerAddressDto: A postal address.
      - `id` string: Server-assigned ID.
      - `line1` string, required: Street address line 1.
      - `line2` string: Street address line 2.
      - `city` string, required: City.
      - `state` string, required: State or province.
      - `postalCode` string, required: Postal or ZIP code.
      - `country` string, required: ISO 3166-1 alpha-3 country code (e.g. USA).
      - `phone` string: Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.
  - `addresses` PartnerCompanyAddressDto[]
    - `provider` 'customer' | 'registeredAgent', required: Who provides this address. Use `customer` to supply the address yourself in the `address` field. Use `registeredAgent` to have doola fill in its Registered Agent address for the company's state; leave `address` out, as it is not used for a registered-agent entry.
    - `type` 'mailing' | 'business', required: Which address this is. Send exactly one `mailing` entry and one `business` entry.
    - `address` PartnerAddressDto: A postal address.
      - `id` string: Server-assigned ID.
      - `line1` string, required: Street address line 1.
      - `line2` string: Street address line 2.
      - `city` string, required: City.
      - `state` string, required: State or province.
      - `postalCode` string, required: Postal or ZIP code.
      - `country` string, required: ISO 3166-1 alpha-3 country code (e.g. USA).
      - `phone` string: Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.
  - `members` PartnerCompanyMemberDto[]
    - `id` string: Server-assigned ID.
    - `legalFirstName` string: Legal first name (natural persons).
    - `legalLastName` string: Legal last name (natural persons).
    - `contactFullName` string: Full contact name (entities or where a single name is used).
    - `isNaturalPerson` boolean, required: True if the member is a person, false if it is another entity.
    - `address` PartnerAddressDto, required: A postal address.
      - `id` string: Server-assigned ID.
      - `line1` string, required: Street address line 1.
      - `line2` string: Street address line 2.
      - `city` string, required: City.
      - `state` string, required: State or province.
      - `postalCode` string, required: Postal or ZIP code.
      - `country` string, required: ISO 3166-1 alpha-3 country code (e.g. USA).
      - `phone` string: Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.
    - `ownershipPercent` number, required: Ownership percentage (0–100).
    - `ssn` string: Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data.
  - `adminNotes` PartnerAdminNoteDto[]: Internal notes visible to the partner.
    - `noteId` string: Note ID.
    - `note` string: Note body.
    - `status` 'Unresolved' | 'Resolved' | 'Deleted': Note status.
    - `createdBy` string: Who created the note.
  - `formationSubmissionStatus` 'AWAITING_PAYMENT' | 'PENDING' | 'SUBMITTED' | 'COMPLETED' | 'FAILED' | 'CANCELLED': Tracks doola's handling of the formation request, from intake until the state filing is recorded. AWAITING_PAYMENT: submitted through the SDK, waiting on your payment confirmation — nothing is filed and no cost is incurred yet. PENDING: request received and being processed. SUBMITTED: accepted and formation started. COMPLETED: the state filing is recorded, set when company_formation_completed fires. FAILED: submission failed (see adminNotes). CANCELLED: withdrawn by doola before payment was confirmed; nothing was filed and a payment confirmation for it is refused.
  - `ein` string: Employer Identification Number, once issued.
  - `formationFilingDate` string, date: Date the formation was filed with the state, once filed.
  - `formationFilingNumber` string, nullable: Filing number assigned by the state when the formation was filed, once filed.
  - `services` PartnerCompanyServiceDto[]: Services attached to the company.
    - `name` string: Service name.
    - `variant` string: Service variant.
    - `status` string: Service status.
    - `subStatus` string: Service sub-status.
  - `executiveMembers` PartnerCCorpExecMemberDto[]: C-Corp officers and directors. Present for a CCorp.
    - `id` string: Server-assigned ID.
    - `type` 'President' | 'Secretary' | 'Treasurer' | 'Director', required: Executive role. The list must include at least one of each role; President, Secretary, and Treasurer may each appear only once, while Director may repeat.
    - `legalFirstName` string, required: Legal first name.
    - `legalLastName` string, required: Legal last name.
    - `ssn` string: Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data.
    - `address` PartnerAddressDto, required: A postal address.
      - `id` string: Server-assigned ID.
      - `line1` string, required: Street address line 1.
      - `line2` string: Street address line 2.
      - `city` string, required: City.
      - `state` string, required: State or province.
      - `postalCode` string, required: Postal or ZIP code.
      - `country` string, required: ISO 3166-1 alpha-3 country code (e.g. USA).
      - `phone` string: Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address.
  - `ccorpValuation` PartnerCcorpValuationDto: C-Corp share structure.
    - `noOfShares` integer, required: Number of authorized shares. Must be greater than 0.
    - `shareValue` number, required: Par value per share, in USD. Must be greater than 0.
  - `signatureRequirements` PartnerSignatureRequirementDto[]: Signature steps required for this company, with their current status. Under the partner workflow, a valid SSN on any member, executive member, or responsible party exempts the company from formation signatures. An ITIN does not grant that exemption. SSNs are checked for format, not issuance. Otherwise SS-4 is required, plus Form 8821 for expedited EIN. Each status is COMPLETED once that document is signed, otherwise PENDING. Always present — an empty list means no signature is required, not that the field is absent.
    - `documentType` 'SS4' | 'FORM8821': Document the signature applies to.
    - `status` 'PENDING' | 'COMPLETED': Whether the signature step is still outstanding or fulfilled.

## Changes

- **2026-11-03** `f607744a8927`: 2 warning, 19 info
  - removed the optional property `error` from the response with the `200` status
  - removed the optional property `payload` from the response with the `200` status
  - added the optional property `addresses` to the response with the `200` status
  - added the optional property `adminNotes` to the response with the `200` status
  - …17 more

[Operation history](https://skmtc.dev/doola/apis/doola-partner-api/changes/v1/partner/companies/:companyId/get.md)

---

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