Skip to main content
GET
Get a company

Authorizations

Authorization
string
header
required

Partner API key. Send the raw key as the Authorization header value — e.g. dk_test_… in sandbox or dk_live_… in production. Generate and rotate keys in the doola Partner Portal.

Path Parameters

companyId
string
required

doola company ID (KSUID).

Response

200 - */*

OK

A company, including formation progress and post-formation details.

doolaCompanyId
string

doola company ID (KSUID).

doolaCustomerId
string

Owning doola customer ID (KSUID).

entityType
enum<string>

Entity type.

Available options:
LLC,
CCorp
Example:

"LLC"

state
string

State of formation.

Example:

"DE"

nameOptions
object[]
naicsCode
string
Example:

"541511"

industry
string

Unique NAICS industry label the company was classified under.

Example:

"Custom Computer Programming Services"

description
string
responsibleParty
object

The person legally responsible for the company (used for tax filings).

addresses
object[]
members
object[]
adminNotes
object[]

Internal notes visible to the partner.

formationSubmissionStatus
enum<string>

Tracks doola's intake of the formation request only, not whether the company is formed. PENDING: request received and being processed. SUBMITTED: accepted and formation started. FAILED: submission failed (see adminNotes). Never reports completion; track the Formation service in the services list, or the company_formation_completed webhook, for that.

Available options:
PENDING,
SUBMITTED,
FAILED
ein
string

Employer Identification Number, once issued.

Example:

"99-1234567"

formationFilingDate
string<date>

Date the formation was filed with the state, once filed.

formationFilingNumber
string | null

Filing number assigned by the state when the formation was filed, once filed.

Example:

"2024-001234567"

services
object[]

Services attached to the company.

executiveMembers
object[]

C-Corp officers and directors. Present for a CCorp.

ccorpValuation
object

C-Corp share structure. Present for a CCorp.

signatureRequirements
object[]

Signature steps required for this company, with their current status. A non-US founder — no member, executive member, or responsible party has an SSN or ITIN — has a single SS-4 requirement; a US founder has an empty list. The status is COMPLETED once the SS-4 has been signed, otherwise PENDING. Always present — an empty list means no signature is required, not that the field is absent.