---
title: "Add Related Company"
method: POST
path: "/verify/add_related_company"
tags: ["KYB > Related Entities V1"]
---

# Add Related Company

`POST /verify/add_related_company`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/verify/add_related_company`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/aiprise/apis/aiprise-apis/docs/verify/add_related_company/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a Related Company for the Business Profile

## Request body

- AddRelatedCompanyRequestSchema
  - `business_profile_id` string, required
  - `name` string, required
  - `country_code` string, nullable
  - `status` string, nullable
  - `description` string, nullable
  - `ownership_percent` number, nullable
  - `shares_allocated` integer, nullable
  - `roles` CompanyRoleDetails[]
    - `name` string, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `is_active` boolean, nullable
    - `normalised_name` 'ULTIMATE_BENEFICIAL_OWNER' | 'CONTROLLING_PERSON' | 'DIRECTOR' | 'LEGAL_REPRESENTATIVE' | 'SHAREHOLDER' | 'EMPLOYEE' | 'UNKNOWN', nullable
  - `addresses` ExtractedAddress[]
    - `full_address` string
    - `parsed_address` object
      - `address_street_1` string: Address street 1
      - `address_street_2` string: Address street 2
      - `address_city` string: Address city
      - `address_state` string: Address state or region
      - `address_zip_code` string: Address zip code
      - `address_country` string: 2-letter address country code
      - `address_type` string: Address type
    - `source` object[]: Source information for the address
      - `type` string
      - `state` string
      - `status` string
      - `file_number` string
      - `labels` string[]
    - `additional_info` object: Additional information about the address (risk indicators, deliverability, etc.)
  - `alternate_name` string: Alternate business name. (DBA)
  - `tax_identification_number` string: Tax ID
  - `website` string: The business website
  - `formation_date` string: The formation date in YYYY-MM-DD format
  - `state_code` string: State Code of the province/region where business is primarily registered.
  - `business_entity_id` string: Entity ID given by the government to the business.
  - `phone_numbers` string[]: List of phone numbers associated with this business
  - `email_addresses` string[]: List of email addresses associated with this business
  - `additional_fields` object

## Response `200`

Successful operation

- object
  - `business_profile_id` string
  - `company_reference_id` string

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-03** `74fc7a5199fb`: 3 info
  - added the new optional request property `roles/items/normalised_name` (media type: application/json)
  - added the new optional request property `roles/items/normalised_name` (media type: application/xml)
  - added the new optional request property `roles/items/normalised_name` (media type: application/x-www-form-urlencoded)

[Operation history](https://skmtc.dev/aiprise/apis/aiprise-apis/changes/verify/add_related_company/post.md)

---

[API](https://skmtc.dev/aiprise/apis/aiprise-apis.md) - [All operations](https://skmtc.dev/aiprise/apis/aiprise-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/aiprise/apis/aiprise-apis/revisions/74fc7a5199fb?raw)