Child Organizations

Register a child organization

curl --request POST \
  --url $baseUrl/organizations/children \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: YOUR_UNIQUE_UUID' \
  --data '{
    "businessName": "Acme Corp",
    "businessType": "Technology",
    "businessEmail": "[email protected]",
    "phoneNumber": "+1234567890",
    "address": "123 Main St",
    "country": "USA",
    "city": "New York",
    "state": "NY",
    "firstname": "Jane",
    "lastname": "Doe",
    "website": "https://www.acmecorp.com"
  }'

Field	Required	Description
`businessName`	Yes	Legal or trading name
`businessType`	Yes	e.g. `Technology`
`businessEmail`	Yes	Primary business email
`phoneNumber`	Yes	Business phone number
`address`, `country`, `city`, `state`	Yes	Business location
`firstname`, `lastname`	Yes	Primary contact person
`website`	No	Business website

This creates both the child organization and its associated owner user account.

Response:

{
  "userId": "user-uuid-123",
  "organizationId": "org-uuid-456"
}

List child organizations

curl --request GET \
  --url $baseUrl/organizations/children \
  --header 'x-api-key: YOUR_API_KEY'

Returns all sub-businesses managed under the authenticated partner organization.

Call this next

Verification Status — each child organization goes through its own KYB