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 |
| 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 |
entityType defaults to LLC. A CCorp swaps members for executiveMembers and ccorpValuation (see below).
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 |
Share structure (CCorp)
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 |
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 | ArticlesOfOrganization, EinLetter, or Mail |
createdAt | Upload timestamp |
lastModified | Last modification timestamp |
downloadUrl | Temporary signed download URL (single document endpoint only) |
