> ## 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. # Get a company > Returns a single company by doola company ID, including formation status, EIN (once issued), members, addresses, and services. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/partner/companies/{companyId} 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 webhooks and event subscriptions 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: Customers description: Create and look up customers under your partner tenant. - name: Documents description: List and download a company's formation documents. - name: Signatures description: Request embedded signing sessions for pending company documents. - name: Companies description: Create companies for your customers, then track formation status. - name: Reference data description: >- Static lookups for building company-creation requests: NAICS codes, states, countries, and state filing fees. paths: /v1/partner/companies/{companyId}: get: tags: - Companies summary: Get a company description: >- Returns a single company by doola company ID, including formation status, EIN (once issued), members, addresses, and services. operationId: getCompanyById parameters: - name: companyId in: path description: doola company ID (KSUID). required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/PartnerCompanyResponse' components: schemas: 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' naicsCode: type: string example: '541511' 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' adminNotes: type: array description: Internal notes visible to the partner. items: $ref: '#/components/schemas/PartnerAdminNoteDto' formationSubmissionStatus: type: string description: >- Tracks doola's intake of the formation request only, not whether the company is formed. PENDING: request received and being processed. SUBMITTED: accepted and formation started. FAILED: submission failed (see adminNotes). Never reports completion; track the Formation service in the services list, or the company_formation_completed webhook, for that. enum: - PENDING - SUBMITTED - FAILED 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. A non-US founder — no member, executive member, or responsible party has an SSN or ITIN — has a single SS-4 requirement; a US founder has an empty list. The status is COMPLETED once the SS-4 has been signed, otherwise PENDING. Always present — an empty list means no signature is required, not that the field is absent. items: $ref: '#/components/schemas/PartnerSignatureRequirementDto' 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 (1 = first choice). 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. readOnly: true 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. Format: 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. readOnly: true 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. Format: XXX-XX-XXXX. Handled as sensitive data. required: - address - isNaturalPerson - ownershipPercent 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. PartnerCCorpExecMemberDto: type: object description: A C-Corp executive member — an officer or director. properties: id: type: string description: Server-assigned ID. readOnly: true 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. Format: 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 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 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 ````