Skip to main content

​
Overview

The Business Entity API provides endpoints for managing legal business entities (corporations, LLCs, partnerships, etc.) and their associated data including locations, persons, government identifiers, registrations, documents, and credentials.

​
Core endpoints

​
Get business entity

Retrieve a single business entity by ID. 
GET /business-entity/:businessEntityId
Path parameters
ParameterTypeDescription
businessEntityIdintegerUnique identifier for the business entity
Query parameters
ParameterTypeDescription
extendsstring[]Optional fields to include: governmentIdentifiers, locations
Response 
{
  "id": 123,
  "legalName": "Acme Corporation",
  "dbaName": "Acme",
  "incorporationCountry": "US",
  "incorporationJurisdiction": "DE",
  "entityType": "C_CORP",
  "formationDate": "2020-01-15",
  "businessDescription": "Software development",
  "fiscalYearEnd": "12-31",
  "accountingBasis": "ACCRUAL",
  "governmentIdentifiers": [...],
  "locations": [...]
}

​
Update business entity

Update core business entity information. 
POST /business-entity/:businessEntityId
Path parameters
ParameterTypeDescription
businessEntityIdintegerUnique identifier for the business entity
Request body 
{
  "legalName": "Acme Corporation Inc.",
  "dbaName": "Acme",
  "businessDescription": "Enterprise software development",
  "fiscalYearEnd": "12-31",
  "accountingBasis": "ACCRUAL",
  "taxClassification": "C_CORP"
}
Response Returns 200 OK on success.

​
List business entities

Get all business entities for a company. 
GET /business-entity/list/company/:companyId
Path parameters
ParameterTypeDescription
companyIdintegerUnique identifier for the company
Response 
{
  "entities": [
    {
      "id": 123,
      "legalName": "Acme Corporation",
      "incorporationCountry": "US",
      "incorporationJurisdiction": "DE"
    }
  ]
}

​
Key persons

​
Add key person

Associate a person with a business entity. 
POST /business-entity/:businessEntityId/persons/:personId
Path parameters
ParameterTypeDescription
businessEntityIdintegerBusiness entity ID
personIdintegerPerson ID
Request body 
{
  "role": "DIRECTOR",
  "startDate": "2020-01-15",
  "endDate": null,
  "ownershipPercentage": 25.5
}
Response Returns 200 OK on success.

​
Remove key person

Remove a person from a business entity. 
DELETE /business-entity/:businessEntityId/persons/:personId
Path parameters
ParameterTypeDescription
businessEntityIdintegerBusiness entity ID
personIdintegerPerson ID
Response Returns 204 No Content on success.

​
Bulk operations

​
Bulk assign

Assign multiple business entities to companies. 
POST /business-entity/bulk/assign
Request body 
[
  {
    "businessEntityId": 123,
    "companyId": 456
  },
  {
    "businessEntityId": 124,
    "companyId": 456
  }
]
Response 
{
  "success": [
    {
      "businessEntityId": 123,
      "companyId": 456
    }
  ],
  "failed": []
}

​
Unassign business entity

Remove a business entity from a company. 
POST /business-entity/unassign
Request body 
{
  "businessEntityId": 123
}
Response Returns 200 OK on success.