Companies

Returns a single company by doola company ID, including formation status, EIN (once issued), members, addresses, and services.

get/v1/partner/companies/{companyId}

Request

  • Base URL
    https://api.test.doola.com
  • URL
    https://api.test.doola.com/v1/partner/companies/{companyId}
  • Auth
    API key in header Authorization

Path parameters

companyIdstring required

doola company ID (KSUID).

Response

OK

doolaCompanyIdstring

doola company ID (KSUID).

doolaCustomerIdstring

Owning doola customer ID (KSUID).

entityType'LLC' | 'CCorp'

Entity type.

statestring

State of formation.

industrystring

Unique NAICS industry label the company was classified under.

descriptionstring
formationSubmissionStatus'AWAITING_PAYMENT' | 'PENDING' | 'SUBMITTED' | 'COMPLETED' | 'FAILED' | 'CANCELLED'

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.

einstring

Employer Identification Number, once issued.

formationFilingDatestring date

Date the formation was filed with the state, once filed.

formationFilingNumberstring nullable

Filing number assigned by the state when the formation was filed, once filed.

Example response

{
  "entityType": "LLC",
  "state": "DE",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC",
      "position": 1
    }
  ],
  "industry": "Custom Computer Programming Services",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "address": {
      "line1": "251 W 30th St",
      "line2": "Ste 12E",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "registeredAgent",
      "type": "business",
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ],
  "members": [
    {
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "contactFullName": "Acme Holdings LLC",
      "isNaturalPerson": true,
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      },
      "ownershipPercent": 100
    }
  ],
  "ein": "99-1234567",
  "formationFilingNumber": "2024-001234567",
  "services": [
    {
      "name": "Registered Agent"
    }
  ],
  "executiveMembers": [
    {
      "type": "President",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ],
  "ccorpValuation": {
    "noOfShares": 10000000,
    "shareValue": 0.0001
  },
  "signatureRequirements": [
    {
      "documentType": "SS4",
      "status": "PENDING"
    }
  ]
}

Changes

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status