Domain objects

This page explains the objects and rules you assemble a request from. The API reference has the complete, generated field list and types; this page focuses on the relationships and validation rules that the schema alone does not spell out.

Customer

Field	Required	Notes
`email`	Yes	Valid email address
`firstName`	Yes	1 to 50 non blank characters
`lastName`	Yes	1 to 50 non blank characters
`countryOfResidence`	Yes	ISO 3166-1 alpha-3 code, for example `USA`. See the countries reference
`phoneNumber`	No	Include the international code, for example `+12125550100`

Company formation

Field	Required	Notes
`doolaCustomerId`	Yes	The id returned by Create customer
`entityType`	No	`LLC` (default) or `CCorp`. Determines which member and valuation fields apply
`state`	Yes	Two letter US state, for example `WY`. See the states reference
`naicsCode`	Yes	A valid code from the NAICS reference
`description`	Yes	Business description, up to 250 characters
`nameOptions`	Yes	1 to 3 ordered name preferences
`members`	Conditional	LLC only. Required for an LLC; ownership must total exactly 100. Omit for a CCorp
`executiveMembers`	Conditional	CCorp only. Required for a CCorp; omit for an LLC
`ccorpValuation`	Conditional	CCorp only. Required for a CCorp; omit for an LLC
`responsibleParty`	Yes	The person responsible for the EIN application
`addresses`	Yes	Exactly two: a mailing address and a business address
`requestedServices`	No	Per-service variant overrides. Only the EIN service is configurable; see Expedited EIN

entityType defaults to LLC. A CCorp swaps members for executiveMembers and ccorpValuation (see below).

US vs non-US founder is derived from the ssn field, which holds a US tax ID (SSN or ITIN). If no member, executiveMember, or responsibleParty supplies one, doola treats the founder as non-US and the response carries a pending SS-4 in signatureRequirements. If anyone supplies an SSN or ITIN, signatureRequirements is empty. See Non-US founders.

Name option

Provide up to three in order of preference. doola uses the first name that clears the state’s availability check.

Field	Required	Notes
`name`	Yes	Company name without the entity suffix
`entityTypeEnding`	Yes	Must match the entity type. LLC: `LLC`, `L.L.C`, `L.L.C.`, `Limited Liability Company`. CCorp: `Inc`, `Inc.`, `Incorporated`, `Corp.`, `Corporation`, `C Corp`, `C Corporation`, `CCorp`, `Company`

Company address

Submit one entry per role. There must be exactly two: a mailing address and a business address.

Field	Required	Notes
`provider`	Yes	`customer` (you supply the address) or `registeredAgent` (doola supplies it)
`type`	Yes	`mailing` or `business`
`address`	Conditional	Required when `provider` is `customer`. Omit it when `provider` is `registeredAgent`

Address

Field	Required	Notes
`line1`	Yes	Street address line 1
`line2`	No	Optional
`city`	Yes	City
`state`	Yes	State, two letter abbreviation for the US
`postalCode`	Yes	Postal or ZIP code
`country`	Yes	ISO 3166-1 alpha-3 code, for example `USA`
`phone`	Conditional	Optional on a plain address, required on a member’s address

Responsible party

The person responsible for the company’s EIN application.

Field	Required	Notes
`legalFirstName`	Yes	Legal first name
`legalLastName`	Yes	Legal last name
`address`	Yes	See Address
`ssn`	No	Optional. Format `XXX-XX-XXXX`
`email`	No	Optional, valid email

Member

The sum of ownershipPercent across all members must equal exactly 100.

Field	Required	Notes
`legalFirstName`	Yes	Legal first name
`legalLastName`	Yes	Legal last name
`contactFullName`	Yes	Full name as it should appear on filings
`isNaturalPerson`	Yes	`true` for an individual, `false` for an entity
`ownershipPercent`	Yes	Must total 100 across all members
`address`	Yes	See Address. `phone` is required here
`ssn`	No	Optional. Format `XXX-XX-XXXX`

Executive member (CCorp)

Supplied as executiveMembers and required for a CCorp. The list must include at least one President, Secretary, Treasurer, and Director. President, Secretary, and Treasurer may each appear only once; Director may repeat.

Field	Required	Notes
`type`	Yes	One of `President`, `Secretary`, `Treasurer`, `Director`
`legalFirstName`	Yes	Legal first name
`legalLastName`	Yes	Legal last name
`address`	Yes	See Address
`ssn`	No	Optional. Format `XXX-XX-XXXX`

Supplied as ccorpValuation and required for a CCorp.

Field	Required	Notes
`noOfShares`	Yes	Number of authorized shares. Greater than 0
`shareValue`	Yes	Par value per share in USD. Greater than 0

Requested service

Supplied as requestedServices, optional. Requests a specific variant for one of the company’s services; today only the expedited EIN, available for non-US founders. See Expedited EIN for availability and errors.

Field	Required	Notes
`service`	Yes	Only `EinCreation` is supported
`variant`	Yes	`Standard` or `Expedite`. `Standard` behaves the same as omitting the entry

Document

Returned by the document endpoints. downloadUrl is present only on the single document endpoint and is a temporary signed URL valid for about one hour.

Field	Notes
`id`	Document id
`companyId`	Parent company id
`name`	File name
`contentType`	MIME type, for example `application/pdf`
`documentType`	Common values: `ArticlesOfOrganization`, `EinLetter`, `Mail`, `CorporateBylaws` (CCorp), `OperatingAgreement` (LLC), `SignedSS4` (non-US founders), and `SignedForm8821` (non-US founders on an expedited EIN). Not a closed set — other document types can appear over a company’s lifetime
`createdAt`	Upload timestamp
`lastModified`	Last modification timestamp
`downloadUrl`	Temporary signed download URL (single document endpoint only)

Signature requirement

Returned on the company as signatureRequirements by both Create company and Retrieve company. The array is always present: an SS4 entry for a non-US founder (plus a FORM8821 entry when that founder is on an expedited EIN), or empty for a US founder. See Non-US founders.

Field	Values	Notes
`documentType`	`SS4`, `FORM8821`	The document the founder must sign
`status`	`PENDING`, `COMPLETED`	`PENDING` until that document is signed, then `COMPLETED`

Signature session

Returned by the create-signature-session endpoint. Holds the short lived, whitelabeled signing link to present to the founder.

Field	Notes
`id`	Identifier for the signing session
`url`	doola signing link to embed or share. Expires at `expiresAt`
`documentType`	`SS4`, `FORM8821`
`expiresAt`	When `url` stops working (two hours after issuance). Request a new session after this

Get started

Core concepts

Reference

API reference

Help

Updates

Customer

Company formation

Name option

Company address

Address

Responsible party

Member

Executive member (CCorp)

Requested service

Document

Signature requirement

Signature session

​Customer

​Company formation

​Name option

​Company address

​Address

​Responsible party

​Member

​Executive member (CCorp)

​Share structure (CCorp)

​Requested service

​Document

​Signature requirement

​Signature session

Customer

Company formation

Name option

Company address

Address

Responsible party

Member

Executive member (CCorp)

Share structure (CCorp)

Requested service

Document

Signature requirement

Signature session