Business entities represent legal/organizational units within a client company. A default one is created during onboarding. Endpoints (all Company Key):
  • POST /v1/business-entities — create a new business entity
  • GET /v1/business-entities — list business entities for the company
  • GET /v1/business-entities/{id} — get specific business entity
  • PATCH /v1/business-entities/{id} — update business entity metadata
Create entity:
  Partner ──POST /v1/business-entities──> API
         <── 200 OK { businessEntityId, name, status, ... }

List entities:
  Partner ──GET /v1/business-entities──> API
         <── 200 OK [ { businessEntityId, name, ... } ]

Update entity:
  Partner ──PATCH /v1/business-entities/{id}──> API
         <── 200 OK { updated entity }
Key behaviors:
  • Business entities created via Partner API are auto-approved (unlike self-service where admin approval may be required)
  • Each business entity can have its own document submissions and compliance reviews
  • The businessEntityId is needed when submitting documents to create a new compliance review
  • Scoped to the authenticated company — cannot access other companies’ entities