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[]
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 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.

Available options:
AWAITING_PAYMENT,
PENDING,
SUBMITTED,
COMPLETED,
FAILED,
CANCELLED
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. 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.