---
title: "Add business"
method: POST
path: "/v1/customers/businesses"
tags: ["Customers"]
---

# Add business

`POST /v1/customers/businesses`

Add business

## Headers

- `Idempotency-Key` string, uuid, nullable

## Request body

- AddBusinessRequest
  - `address` Address, required
    - `country_code` string, string, required
    - `line_1` string, string, required
    - `line_2` string, string, nullable — ***optional*** for `AED` payments but ***mandatory*** for `USD` payments
    - `line_3` string, string, nullable
    - `line_4` string, string, nullable
  - `business_name` string, string, required
  - `country_of_issuance` string, string, required
  - `currency_extra` BusinessCurrencyExtra[], nullable
    - union — Represents the currency specific data for a business.
      - object
        - `currency` 'usd', required
        - `industry_code` string, string, required — US industry code as defined by the North American Industry Classification System (NAICS) system. See https://reference.fuse.me/naics.html for supported list of codes.
        - `ip_address` string, string — Optional IP address to use as a Proof of Address. Can be in IPv4 or IPv6 format.
        - `tax_number` string, string, required — Valid business tax number.
      - object
        - `currency` 'aed', required
        - `license_issuer` 'mainland' | 'freezone' | 'international', required
        - `trade_license_expiry` string, date, nullable
  - `display_name` string, string, required
  - `issuance_authority` string, string, nullable
  - `linked_documents` string[] — Document ids for the companies trading licenses.
  - `reference` string, string, required — External ID used for correlating the resource with an external system. If specified during transaction creation, this ID will be associated with and visible on all resources related to the customer.
  - `registration_date` string, date, nullable
  - `registration_number` string, string, required
  - `regulatory_licenses` RegulatoryLicenseType[] — Select one or more license types that the customer holds. If the customer does not hold any licenses then None should be selected.
  - `relationship_type` union — Represents the relationship between a customer and the organisation.
    - 'direct' — The customer is a direct customer of the organisation. The customer is contracted with the organisation.
    - object — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
      - `indirect` object, required — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
        - `parent_customer_id` string, uuid, required

## Response `201`

Business has been created successfully

- AddCustomerResponse
  - `id` string, Uuid, required

## Other responses

- `400` — Invalid request
- `401` — Authentication error
- `409` — Conflict error
- `500` — Internal server error

---

[API](https://skmtc.net/lorum/apis/auth-api.md) · [All operations](https://skmtc.net/lorum/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lorum/auth-api/revisions/f9b8935027e3/schema)