> ## Documentation Index > Fetch the complete documentation index at: https://docs.doola.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Authenticate with the raw API key in the Authorization header. Never add a Bearer prefix. > Use the sandbox base URL https://api.test.doola.com and a dk_test_ key in examples unless the user asks for production. > Send an Idempotency-Key header on POST /v1/partner/customers, POST /v1/partner/companies, POST /v1/partner/companies/import, POST /v1/partner/companies/{companyId}/services and POST /v1/partner/companies/{companyId}/documents. No other endpoint takes one. > Every response is wrapped as {payload, error}. Read fields from payload and branch on error.code, never on the message. > Drive formation progress from webhooks plus a reconciliation sweep, never a polling loop. > Embedded SDK (@doola/js): the dk_ key stays on the server and mints customer sessions; the browser gets only a pk_ key and the session. onFormed carries only companyId and can fire more than once. Before charging, read the company with the dk_ key, require formationSubmissionStatus AWAITING_PAYMENT, check the owner's email, and price on the server. Then POST payment-confirmed, which answers 200 with an empty body, and replace the SDK element with a new doola.create() (never append a second one). > The doola Formation MCP server at https://mcp.doola.com is for founders forming their own company with their own doola account. Partners integrate the Partner API or the Embedded SDK. The /mcp endpoint on this docs site only searches these docs. > For a full capability summary with the rules above, read https://docs.doola.com/skill.md. # Import a company > Records a company your customer already formed outside doola, so you can add doola services to it. Nothing is filed: no formation, registered agent or EIN work starts, and no formation webhook is sent. Send the company as the state has it on file, including its legal name, formation filing number and date and its current registered agent. Idempotent on the `Idempotency-Key` header, like company creation. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/partner/companies/import openapi: 3.1.0 info: title: doola Partner API description: >- REST API for doola partners to create and manage customers and companies, retrieve formation documents, and look up reference data. Authenticate every request with a partner API key in the `Authorization` header. Generate keys and manage your webhook endpoint in the doola Partner Portal. contact: name: doola url: https://www.doola.com version: v1 servers: - url: https://api.test.doola.com description: Sandbox — use test keys (dk_test_…) - url: https://api.doola.com description: Production — use live keys (dk_live_…) security: - PartnerApiKey: [] tags: - name: Playground (sandbox only) description: >- Sandbox-only helpers to drive a test company through the Formation and EinCreation milestones end to end. - name: Required Actions description: >- Actions doola needs you to take on a company, such as supplying new name options after a state rejection. - name: Customers description: Create and look up customers under your partner tenant. - name: Compliance description: Track a company's compliance obligations and their due dates. - name: Annual Report Filing description: >- File a company's annual report with its state: what to collect, what it costs, submission, confirmation and status. - name: Customer sessions description: Mint the token the doola SDK uses in your customer's browser. - name: Signatures description: Request embedded signing sessions for pending company documents. - name: Companies description: >- Create or import companies for your customers, then track formation status. - name: Documents description: List, download and upload a company's formation documents. - name: Companies description: Create companies for your customers, then track formation status. - name: SDK description: Keys for the doola Embedded SDK. - name: Reference data description: >- Static lookups for building company-creation requests: NAICS codes, states, countries, and state filing fees. paths: /v1/partner/companies/import: post: tags: - Companies summary: Import a company description: >- Records a company your customer already formed outside doola, so you can add doola services to it. Nothing is filed: no formation, registered agent or EIN work starts, and no formation webhook is sent. Send the company as the state has it on file, including its legal name, formation filing number and date and its current registered agent. Idempotent on the `Idempotency-Key` header, like company creation. operationId: importCompany parameters: - name: Idempotency-Key in: header description: >- 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. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ImportCompanyRequest' examples: Member-managed LLC import: description: Member-managed LLC import value: 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 Manager-managed LLC import: description: Manager-managed LLC import value: doolaCustomerId: 3GS8Guk4H6BiP8tgfNVIQDFvKQ9 entityType: LLC managementType: MANAGER_MANAGED state: WY nameOptions: - name: Acme Labs entityTypeEnding: LLC formationFilingDate: '2023-04-12' formationFilingNumber: 2023-001234567 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' managers: - legalFirstName: Grace legalLastName: Hopper email: grace@example.com ssn: 987-65-4321 address: line1: 251 W 30th St city: New York state: NY postalCode: '10001' country: USA phone: '+12125550102' registeredAgent: name: Wyoming Registered Agents LLC address: line1: 30 N Gould St city: Sheridan state: WY postalCode: '82801' country: USA required: true responses: '201': description: >- 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. content: '*/*': schema: $ref: '#/components/schemas/PartnerCompanyResponse' '400': description: >- E_VALIDATION_FAILED: a required field is missing or a value is invalid; each field carries its own code, for example E_FORMATION_FILING_NUMBER_INVALID or E_NAME_OPTIONS_INVALID. E_IDEMPOTENCY_KEY_REQUIRED: the Idempotency-Key header is missing. '404': description: >- E_CUSTOMER_NOT_FOUND: no such customer for the authenticated partner. '409': description: >- E_COMPANY_ALREADY_REGISTERED: a company with this state and formation filing number is already registered with doola. When it is one of your own companies, the message names its doola company ID; otherwise it names none. components: schemas: ImportCompanyRequest: type: object description: >- Request body to import a company your customer already formed outside doola. Nothing is filed: the company is recorded as it exists today. properties: doolaCustomerId: type: string description: doola customer ID (KSUID) that owns the company. minLength: 1 entityType: type: string description: >- Entity type. An LLC takes `members`; a CCorp takes `executiveMembers` and `ccorpValuation`. enum: - LLC - CCorp example: LLC minLength: 1 managementType: type: string description: >- Who runs the LLC. Required for an LLC, where `members` lists the owners either way; omit for a CCorp, which its officers run. enum: - MEMBER_MANAGED - MANAGER_MANAGED example: MEMBER_MANAGED state: type: string description: US state of formation (two-letter abbreviation). example: WY minLength: 1 nameOptions: type: array description: >- 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. items: $ref: '#/components/schemas/PartnerCompanyNameOptionDto' formationFilingDate: type: string format: date description: Date the state formed the company. Cannot be in the future. example: '2023-04-12' formationFilingNumber: type: string description: >- Filing number the state assigned when it formed the company. A state and filing number can be registered with doola only once. example: 2023-001234567 maxLength: 255 minLength: 0 ein: type: string description: Employer Identification Number, if the company has one. example: 99-1234567 pattern: ^[0-9]{2}-[0-9]{7}$ industry: type: string description: >- Unique NAICS industry label (the `industry` value from GET /v1/partner/references/naics-codes). example: Custom Computer Programming Services minLength: 1 description: type: string description: Short description of what the business does. example: Custom software development for small businesses. maxLength: 50 minLength: 1 responsibleParty: $ref: '#/components/schemas/PartnerResponsiblePartyDto' description: The person legally responsible for the company. addresses: type: array description: >- 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. items: $ref: '#/components/schemas/PartnerCompanyAddressDto' members: type: array description: >- LLC members with their ownership percentages, which must total 100. Required for an LLC; omit for a CCorp. items: $ref: '#/components/schemas/PartnerCompanyMemberDto' managers: type: array description: >- 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. items: $ref: '#/components/schemas/PartnerCompanyManagerDto' executiveMembers: type: array description: >- C-Corp officers and directors. Required for a CCorp; omit for an LLC. Include at least one President, Secretary, Treasurer, and Director. items: $ref: '#/components/schemas/PartnerCCorpExecMemberDto' ccorpValuation: $ref: '#/components/schemas/PartnerCcorpValuationDto' description: >- C-Corp authorized shares and par value. Required for a CCorp; omit for an LLC. registeredAgent: $ref: '#/components/schemas/PartnerRegisteredAgentDto' required: - addresses - description - doolaCustomerId - entityType - formationFilingDate - formationFilingNumber - industry - nameOptions - registeredAgent - responsibleParty - state PartnerCompanyResponse: type: object description: A company, including formation progress and post-formation details. properties: doolaCompanyId: type: string description: doola company ID (KSUID). doolaCustomerId: type: string description: Owning doola customer ID (KSUID). entityType: type: string description: Entity type. enum: - LLC - CCorp example: LLC state: type: string description: State of formation. example: DE nameOptions: type: array items: $ref: '#/components/schemas/PartnerCompanyNameOptionDto' industry: type: string description: Unique NAICS industry label the company was classified under. example: Custom Computer Programming Services description: type: string responsibleParty: $ref: '#/components/schemas/PartnerResponsiblePartyDto' addresses: type: array items: $ref: '#/components/schemas/PartnerCompanyAddressDto' members: type: array items: $ref: '#/components/schemas/PartnerCompanyMemberDto' managementType: type: string description: >- 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. enum: - MEMBER_MANAGED - MANAGER_MANAGED example: MEMBER_MANAGED managers: type: array description: >- Managers of a manager-managed LLC, with masked SSNs. Present only when `managementType` is `MANAGER_MANAGED`; `members` still lists the owners. items: $ref: '#/components/schemas/PartnerCompanyManagerDto' adminNotes: type: array description: Internal notes visible to the partner. items: $ref: '#/components/schemas/PartnerAdminNoteDto' formationSubmissionStatus: type: string description: >- 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. enum: - AWAITING_PAYMENT - PENDING - SUBMITTED - COMPLETED - FAILED - CANCELLED ein: type: string description: Employer Identification Number, once issued. example: 99-1234567 formationFilingDate: type: string format: date description: Date the formation was filed with the state, once filed. formationFilingNumber: type: - string - 'null' description: >- Filing number assigned by the state when the formation was filed, once filed. example: 2024-001234567 services: type: array description: Services attached to the company. items: $ref: '#/components/schemas/PartnerCompanyServiceDto' executiveMembers: type: array description: C-Corp officers and directors. Present for a CCorp. items: $ref: '#/components/schemas/PartnerCCorpExecMemberDto' ccorpValuation: $ref: '#/components/schemas/PartnerCcorpValuationDto' description: C-Corp share structure. Present for a CCorp. signatureRequirements: type: array description: >- 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. items: $ref: '#/components/schemas/PartnerSignatureRequirementDto' origin: type: string description: >- DOOLA for a company doola formed through the API, IMPORTED for one the partner imported after forming it elsewhere. enum: - DOOLA - IMPORTED example: DOOLA importStatus: type: string description: >- 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. enum: - AWAITING_DOCUMENTS - IN_REVIEW - VERIFIED example: AWAITING_DOCUMENTS documentRequirements: type: array description: >- 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. items: $ref: '#/components/schemas/PartnerDocumentRequirementDto' PartnerCompanyNameOptionDto: type: object description: A candidate company name. properties: id: type: string description: Server-assigned ID. readOnly: true name: type: string description: Proposed company name, without the entity ending. example: Acme Labs entityTypeEnding: type: string description: Entity-type ending appended to the name. example: LLC position: type: integer format: int32 description: >- Preference order, lowest first. Ignored on create, where array order sets the preference and responses return it starting at 0. On a name-options resolution, options are ordered by this value, or by array order when it is omitted. example: 1 required: - entityTypeEnding - name PartnerResponsiblePartyDto: type: object description: The person legally responsible for the company (used for tax filings). properties: id: type: string description: >- Server-assigned ID, ignored on create and import. In the importCorrections of an IMPORT_INFO_REQUIRED resolution, send it back to keep this person and their stored SSN. legalFirstName: type: string description: Legal first name. example: Ada legalLastName: type: string description: Legal last name. example: Lovelace ssn: type: string description: >- Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data. email: type: string description: Contact email. example: ada@example.com address: $ref: '#/components/schemas/PartnerAddressDto' description: Responsible party's address. required: - email - legalFirstName - legalLastName PartnerCompanyAddressDto: type: object description: A company address of a given type. properties: provider: type: string description: >- Who provides this address. Use `customer` to supply the address yourself in the `address` field. Use `registeredAgent` to have doola fill in its Registered Agent address for the company's state; leave `address` out, as it is not used for a registered-agent entry. enum: - customer - registeredAgent example: registeredAgent type: type: string description: >- Which address this is. Send exactly one `mailing` entry and one `business` entry. enum: - mailing - business example: business address: $ref: '#/components/schemas/PartnerAddressDto' description: The address itself. required: - provider - type PartnerCompanyMemberDto: type: object description: A company member/owner. Ownership across all members must total 100. properties: id: type: string description: >- Server-assigned ID, ignored on create and import. In the importCorrections of an IMPORT_INFO_REQUIRED resolution, send it back to keep this person and their stored SSN. legalFirstName: type: string description: Legal first name (natural persons). example: Ada legalLastName: type: string description: Legal last name (natural persons). example: Lovelace contactFullName: type: string description: Full contact name (entities or where a single name is used). example: Acme Holdings LLC isNaturalPerson: type: boolean description: True if the member is a person, false if it is another entity. example: true address: $ref: '#/components/schemas/PartnerAddressDto' description: Member's address. ownershipPercent: type: number description: Ownership percentage (0–100). example: 100 ssn: type: string description: >- Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data. required: - address - isNaturalPerson - ownershipPercent PartnerCompanyManagerDto: type: object description: 'A manager of a manager-managed LLC: a person who runs the company.' properties: id: type: string description: >- Server-assigned ID, ignored on create and import. In the importCorrections of an IMPORT_INFO_REQUIRED resolution, send it back to keep this person and their stored SSN. legalFirstName: type: string description: Manager's legal first name. example: Grace legalLastName: type: string description: Manager's legal last name. example: Hopper ssn: type: string description: >- Manager's Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data. email: type: string description: Manager's contact email. example: grace@example.com address: $ref: '#/components/schemas/PartnerAddressDto' description: Manager's address. When sent, a phone number is required. required: - email - legalFirstName - legalLastName PartnerCCorpExecMemberDto: type: object description: A C-Corp executive member — an officer or director. properties: id: type: string description: >- Server-assigned ID, ignored on create and import. In the importCorrections of an IMPORT_INFO_REQUIRED resolution, send it back to keep this person and their stored SSN. type: type: string description: >- Executive role. The list must include at least one of each role; President, Secretary, and Treasurer may each appear only once, while Director may repeat. enum: - President - Secretary - Treasurer - Director example: President legalFirstName: type: string description: Legal first name. example: Ada legalLastName: type: string description: Legal last name. example: Lovelace ssn: type: string description: >- Social Security Number or ITIN. Optional. Input: nine ASCII digits or XXX-XX-XXXX. Handled as sensitive data. address: $ref: '#/components/schemas/PartnerAddressDto' description: Executive member's address. required: - address - legalFirstName - legalLastName - type PartnerCcorpValuationDto: type: object description: C-Corp share structure. properties: noOfShares: type: integer format: int32 description: Number of authorized shares. Must be greater than 0. example: 10000000 shareValue: type: number description: Par value per share, in USD. Must be greater than 0. example: 0.0001 required: - noOfShares - shareValue PartnerRegisteredAgentDto: type: object description: The registered agent the company has today. properties: name: type: string description: Registered agent's name, as filed with the state. example: Wyoming Registered Agents LLC address: $ref: '#/components/schemas/PartnerAddressDto' description: The registered agent's address as filed with the state. required: - address - name PartnerAdminNoteDto: type: object description: A note attached to a company. properties: noteId: type: string description: Note ID. note: type: string description: Note body. status: type: string description: Note status. enum: - Unresolved - Resolved - Deleted createdBy: type: string description: Who created the note. PartnerCompanyServiceDto: type: object description: A service attached to a company. properties: name: type: string description: Service name. example: Registered Agent variant: type: string description: Service variant. status: type: string description: Service status. subStatus: type: string description: Service sub-status. PartnerSignatureRequirementDto: type: object description: A signature step required for the company. properties: documentType: type: string description: Document the signature applies to. enum: - SS4 - FORM8821 example: SS4 status: type: string description: Whether the signature step is still outstanding or fulfilled. enum: - PENDING - COMPLETED example: PENDING PartnerDocumentRequirementDto: type: object description: A document an imported company must have on file, and whether it does. properties: documentType: type: string description: >- The document type to upload with POST /v1/partner/companies/{companyId}/documents. enum: - ArticlesOfOrganization - EinLetter example: ArticlesOfOrganization status: type: string description: Whether a document of this type is on file. enum: - missing - received example: missing PartnerAddressDto: type: object description: A postal address. properties: id: type: string description: Server-assigned ID. readOnly: true line1: type: string description: Street address line 1. example: 251 W 30th St line2: type: string description: Street address line 2. example: Ste 12E city: type: string description: City. example: New York state: type: string description: State or province. example: NY postalCode: type: string description: Postal or ZIP code. example: '10001' country: type: string description: ISO 3166-1 alpha-3 country code (e.g. USA). example: USA phone: type: string description: >- Phone number in E.164 format. Required for a person's address (the responsible party, a member, or an executive member); optional for a company `mailing` or `business` address. example: '+12125550100' required: - city - country - line1 - postalCode - state securitySchemes: PartnerApiKey: type: apiKey description: >- 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. name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.