Import a company

curl --request POST \
  --url https://api.test.doola.com/v1/partner/companies/import \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "doolaCustomerId": "3GS8Guk4H6BiP8tgfNVIQDFvKQ9",
  "entityType": "LLC",
  "managementType": "MEMBER_MANAGED",
  "state": "WY",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC"
    }
  ],
  "formationFilingDate": "2023-04-12",
  "formationFilingNumber": "2023-001234567",
  "ein": "99-1234567",
  "industry": "Custom Computer Programming Services",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "ssn": "123-45-6789",
    "address": {
      "line1": "251 W 30th St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "customer",
      "type": "business",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    },
    {
      "provider": "customer",
      "type": "mailing",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    }
  ],
  "members": [
    {
      "isNaturalPerson": true,
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "ownershipPercent": 100,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ],
  "registeredAgent": {
    "name": "Wyoming Registered Agents LLC",
    "address": {
      "line1": "30 N Gould St",
      "city": "Sheridan",
      "state": "WY",
      "postalCode": "82801",
      "country": "USA"
    }
  }
}
'

{
  "doolaCompanyId": "<string>",
  "doolaCustomerId": "<string>",
  "entityType": "LLC",
  "state": "DE",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC",
      "id": "<string>",
      "position": 1
    }
  ],
  "industry": "Custom Computer Programming Services",
  "description": "<string>",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "id": "<string>",
    "ssn": "<string>",
    "address": {
      "line1": "251 W 30th St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "id": "<string>",
      "line2": "Ste 12E",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "registeredAgent",
      "type": "business",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      }
    }
  ],
  "members": [
    {
      "isNaturalPerson": true,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      },
      "ownershipPercent": 100,
      "id": "<string>",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "contactFullName": "Acme Holdings LLC",
      "ssn": "<string>"
    }
  ],
  "managementType": "MEMBER_MANAGED",
  "managers": [
    {
      "legalFirstName": "Grace",
      "legalLastName": "Hopper",
      "email": "grace@example.com",
      "id": "<string>",
      "ssn": "<string>",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      }
    }
  ],
  "adminNotes": [
    {
      "noteId": "<string>",
      "note": "<string>",
      "status": "Unresolved",
      "createdBy": "<string>"
    }
  ],
  "formationSubmissionStatus": "AWAITING_PAYMENT",
  "ein": "99-1234567",
  "formationFilingDate": "2023-12-25",
  "formationFilingNumber": "2024-001234567",
  "services": [
    {
      "name": "Registered Agent",
      "variant": "<string>",
      "status": "<string>",
      "subStatus": "<string>"
    }
  ],
  "executiveMembers": [
    {
      "type": "President",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      },
      "id": "<string>",
      "ssn": "<string>"
    }
  ],
  "ccorpValuation": {
    "noOfShares": 10000000,
    "shareValue": 0.0001
  },
  "signatureRequirements": [
    {
      "documentType": "SS4",
      "status": "PENDING"
    }
  ],
  "origin": "DOOLA",
  "importStatus": "AWAITING_DOCUMENTS",
  "documentRequirements": [
    {
      "documentType": "ArticlesOfOrganization",
      "status": "missing"
    }
  ]
}

POST

partner

companies

import

curl --request POST \
  --url https://api.test.doola.com/v1/partner/companies/import \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "doolaCustomerId": "3GS8Guk4H6BiP8tgfNVIQDFvKQ9",
  "entityType": "LLC",
  "managementType": "MEMBER_MANAGED",
  "state": "WY",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC"
    }
  ],
  "formationFilingDate": "2023-04-12",
  "formationFilingNumber": "2023-001234567",
  "ein": "99-1234567",
  "industry": "Custom Computer Programming Services",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "ssn": "123-45-6789",
    "address": {
      "line1": "251 W 30th St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "customer",
      "type": "business",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    },
    {
      "provider": "customer",
      "type": "mailing",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    }
  ],
  "members": [
    {
      "isNaturalPerson": true,
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "ownershipPercent": 100,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ],
  "registeredAgent": {
    "name": "Wyoming Registered Agents LLC",
    "address": {
      "line1": "30 N Gould St",
      "city": "Sheridan",
      "state": "WY",
      "postalCode": "82801",
      "country": "USA"
    }
  }
}
'

{
  "doolaCompanyId": "<string>",
  "doolaCustomerId": "<string>",
  "entityType": "LLC",
  "state": "DE",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC",
      "id": "<string>",
      "position": 1
    }
  ],
  "industry": "Custom Computer Programming Services",
  "description": "<string>",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "id": "<string>",
    "ssn": "<string>",
    "address": {
      "line1": "251 W 30th St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "id": "<string>",
      "line2": "Ste 12E",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "registeredAgent",
      "type": "business",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      }
    }
  ],
  "members": [
    {
      "isNaturalPerson": true,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      },
      "ownershipPercent": 100,
      "id": "<string>",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "contactFullName": "Acme Holdings LLC",
      "ssn": "<string>"
    }
  ],
  "managementType": "MEMBER_MANAGED",
  "managers": [
    {
      "legalFirstName": "Grace",
      "legalLastName": "Hopper",
      "email": "grace@example.com",
      "id": "<string>",
      "ssn": "<string>",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      }
    }
  ],
  "adminNotes": [
    {
      "noteId": "<string>",
      "note": "<string>",
      "status": "Unresolved",
      "createdBy": "<string>"
    }
  ],
  "formationSubmissionStatus": "AWAITING_PAYMENT",
  "ein": "99-1234567",
  "formationFilingDate": "2023-12-25",
  "formationFilingNumber": "2024-001234567",
  "services": [
    {
      "name": "Registered Agent",
      "variant": "<string>",
      "status": "<string>",
      "subStatus": "<string>"
    }
  ],
  "executiveMembers": [
    {
      "type": "President",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "id": "<string>",
        "line2": "Ste 12E",
        "phone": "+12125550100"
      },
      "id": "<string>",
      "ssn": "<string>"
    }
  ],
  "ccorpValuation": {
    "noOfShares": 10000000,
    "shareValue": 0.0001
  },
  "signatureRequirements": [
    {
      "documentType": "SS4",
      "status": "PENDING"
    }
  ],
  "origin": "DOOLA",
  "importStatus": "AWAITING_DOCUMENTS",
  "documentRequirements": [
    {
      "documentType": "ArticlesOfOrganization",
      "status": "missing"
    }
  ]
}

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.

Headers

Idempotency-Key

string

required

Unique key that makes the import safe to retry. Reuse the same value to retry; if the import fails before committing, the key is released, so retry with the same value.

Body

application/json

Request body to import a company your customer already formed outside doola. Nothing is filed: the company is recorded as it exists today.

doolaCustomerId

string

required

doola customer ID (KSUID) that owns the company.

Minimum string length: 1

entityType

enum<string>

required

Entity type. An LLC takes members; a CCorp takes executiveMembers and ccorpValuation.

Available options:

LLC,

CCorp

Minimum string length: 1

Example:

"LLC"

state

string

required

US state of formation (two-letter abbreviation).

Minimum string length: 1

Example:

"WY"

nameOptions

object[]

required

The legal name as filed with the state, as exactly one name option: the name without the entity ending, and an ending that belongs to entityType. position is ignored.

Show child attributes

formationFilingDate

string<date>

required

Date the state formed the company. Cannot be in the future.

Example:

"2023-04-12"

formationFilingNumber

string

required

Filing number the state assigned when it formed the company. A state and filing number can be registered with doola only once.

Maximum string length: 255

Example:

"2023-001234567"

industry

string

required

Unique NAICS industry label (the industry value from GET /v1/partner/references/naics-codes).

Minimum string length: 1

Example:

"Custom Computer Programming Services"

description

string

required

Short description of what the business does.

Required string length: 1 - 50

Example:

"Custom software development for small businesses."

responsibleParty

object

required

The person legally responsible for the company.

Show child attributes

addresses

object[]

required

The company's principal (business) and mailing addresses. Exactly one of each, both with provider set to customer: doola is not the company's registered agent.

Show child attributes

registeredAgent

object

required

The registered agent the company has today.

Show child attributes

managementType

enum<string>

Who runs the LLC. Required for an LLC, where members lists the owners either way; omit for a CCorp, which its officers run.

Available options:

MEMBER_MANAGED,

MANAGER_MANAGED

Example:

"MEMBER_MANAGED"

ein

string

Employer Identification Number, if the company has one.

Pattern: ^[0-9]{2}-[0-9]{7}$

Example:

"99-1234567"

members

object[]

LLC members with their ownership percentages, which must total 100. Required for an LLC; omit for a CCorp.

Show child attributes

managers

object[]

Managers of a manager-managed LLC: at least one is required when managementType is MANAGER_MANAGED, and none may be sent otherwise. Each follows the same rules as responsibleParty. members still lists the owners.

Show child attributes

executiveMembers

object[]

C-Corp officers and directors. Required for a CCorp; omit for an LLC. Include at least one President, Secretary, Treasurer, and Director.

Show child attributes

ccorpValuation

object

C-Corp authorized shares and par value. Required for a CCorp; omit for an LLC.

Show child attributes

Response

Imported. importStatus is AWAITING_DOCUMENTS and documentRequirements lists the documents to upload next: the Articles always, and the EIN letter when you sent an EIN.

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

Show child attributes

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

Show child attributes

addresses

object[]

Show child attributes

members

object[]

Show child attributes

managementType

enum<string>

Who runs the LLC: MEMBER_MANAGED, its owners, or MANAGER_MANAGED, the people in managers. Absent for a CCorp and for an LLC that did not state it.

Available options:

MEMBER_MANAGED,

MANAGER_MANAGED

Example:

"MEMBER_MANAGED"

managers

object[]

Managers of a manager-managed LLC, with masked SSNs. Present only when managementType is MANAGER_MANAGED; members still lists the owners.

Show child attributes

adminNotes

object[]

Internal notes visible to the partner.

Show child attributes

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.

Show child attributes

executiveMembers

object[]

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

Show child attributes

ccorpValuation

object

C-Corp share structure. Present for a CCorp.

Show child attributes

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.

Show child attributes

origin

enum<string>

DOOLA for a company doola formed through the API, IMPORTED for one the partner imported after forming it elsewhere.

Available options:

DOOLA,

IMPORTED

Example:

"DOOLA"

importStatus

enum<string>

Where an imported company stands. AWAITING_DOCUMENTS: the documents in documentRequirements are not all on file. IN_REVIEW: they are, and the company is being checked. VERIFIED: the company was checked; annual filing is allowed. A verified company can go back to IN_REVIEW if it needs another check. Absent for a company formed through doola.

Available options:

AWAITING_DOCUMENTS,

IN_REVIEW,

VERIFIED

Example:

"AWAITING_DOCUMENTS"

documentRequirements

object[]

The documents an imported company must upload: the Articles always, and the EIN letter when the import sent an EIN. Absent for a company formed through doola.

Show child attributes

Get started

Core concepts

Reference

API reference

Help

Updates

Authorizations

Headers

Body

Response