Skip to main content
POST

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).

requiredActionId
string
required

Required action ID (KSUID).

Body

application/json

Resolution payload for a required action

actionCode
enum<string>
required

The code of the required action being resolved

Available options:
FORMATION_NAME_OPTIONS_EXHAUSTED,
FORMATION_FOUNDER_ADDRESS_REQUIRED,
ANNUAL_REPORT_ADDRESS_NOT_ACCEPTED,
ANNUAL_REPORT_SHARE_VALUE_TOO_HIGH,
IMPORT_INFO_REQUIRED
Example:

"FORMATION_NAME_OPTIONS_EXHAUSTED"

nameOptions
object[]

Replacement company names, in preference order, one to three entries. Required when actionCode is FORMATION_NAME_OPTIONS_EXHAUSTED.

addresses
object[]

The founder's own US address, as exactly one business and one mailing entry, both with provider: customer and country: USA (exactly that value). Required when actionCode is FORMATION_FOUNDER_ADDRESS_REQUIRED.

companyDetails
object

The corrected company details. Required when actionCode is ANNUAL_REPORT_ADDRESS_NOT_ACCEPTED or ANNUAL_REPORT_SHARE_VALUE_TOO_HIGH. Send the fields the action's requestedFieldIds names and nothing else; any other field is refused. A named field you leave out keeps the value doola holds.

importCorrections
object

For IMPORT_INFO_REQUIRED: the corrected company fields. Send exactly the fields the action lists in requestedFieldIds; a missing or extra field is refused. legalName is sent as nameOptions with one entry.

documentIds
string[]

For IMPORT_INFO_REQUIRED: ids of documents you uploaded to this company with POST /v1/partner/companies/{companyId}/documents before answering. Each must belong to the company, and together they must cover every type the action lists in requestedDocumentTypes. Adding an EIN to a company that had none also needs an EinLetter.

Maximum array length: 10
Minimum string length: 1

Response

200 - */*

OK

An action doola needs you to take on a company

requiredActionId
string
Example:

"31pLdpvMh4OfO90moxLgLT8AuQr"

doolaCompanyId
string
Example:

"31pLD0Tq2lm2FsgRBoHv4x3BpzZ"

actionCode
enum<string>

What is needed

Available options:
FORMATION_NAME_OPTIONS_EXHAUSTED,
FORMATION_SIGNATURE_SS4_RESET,
FORMATION_SIGNATURE_FORM8821_REQUIRED,
FORMATION_FOUNDER_ADDRESS_REQUIRED,
ANNUAL_REPORT_ADDRESS_NOT_ACCEPTED,
ANNUAL_REPORT_SHARE_VALUE_TOO_HIGH,
IMPORT_DOCUMENTS_MISSING,
IMPORT_INFO_REQUIRED
Example:

"FORMATION_NAME_OPTIONS_EXHAUSTED"

actionName
string

Human-readable label for the action

Example:

"New company names needed"

status
enum<string>
Available options:
created,
delivered,
delivery_failed,
submitted,
rejected,
resolved
Example:

"delivered"

reason
string

Human-readable explanation you can surface to your user

Example:

"All submitted company name options were rejected by the state. Submit new options."

requestedFieldIds
string[]

Field ids to send back when resolving. For the annual report actions, named as GET /compliance/annual-reports/requirements names them; for IMPORT_INFO_REQUIRED, the company fields to update, named as the company resource names them. Empty when closing the action needs something other than field values.

Example:
requestedDocumentTypes
string[]

Document types to upload to the company before resolving, spelled as the document upload takes them. Empty unless the action asks for documents.

Example:
open
boolean
awaitingResponse
boolean

True while doola is waiting for you to act on this action; false once you have submitted a resolution or the action is closed

updatedAt
string<date-time>

When this action last changed

history
object[]