# Business Identification Number

**Note:** Use this service to submit the German **Economic Identification Number (WIdNr)**; it is separate from the standard **Tax ID (TIN)** and the **Business Identification (BKYC)** process.

**Overview:**
The Business Identification Number API manages critical regulatory identifiers required for business onboarding and compliance. 

**Business Identification Numbers (BIN):**
A BIN (e.g., Wirtschafts-Identifikationsnummer (WIdNr)) is mandatory for businesses in specific jurisdictions. This service allows you to:
1. **Submit** a BIN or provide a formal reason for its absence.
2. **Retrieve** existing records to verify onboarding status.
3. **Update** records if corrections are required.
  
**Lifecycle & Validation:**
Every BIN record must strictly adhere to regional formats (e.g., `DE` prefix). If a number cannot be provided, a standardized `reason_no_number` must be supplied.    


## Create a business identification number

 - [POST /v1/businesses/{business_id}/business_identification_numbers](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-identification-number/createbusinessbin.md): Creates a new business identification number (BIN) (e.g., Wirtschafts-Identifikationsnummer (WIdNr)) record for a given business. Detailed validation rules regarding format and conditional requirements are  defined in the Business Identification Number schema below.
Duplicate entries (same business and number) are not allowed.

## Get a specific business identification number

 - [GET /v1/businesses/{business_id}/business_identification_numbers/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-identification-number/getbusinessbin.md): Retrieves a specific business identification number record associated with a business. This endpoint returns the full details of the record, including the unique identifier (UID), the assigned number (if available), and any reasons provided for the absence of a number.

## Update a business identification number

 - [PATCH /v1/businesses/{business_id}/business_identification_numbers/{id}](https://docs.solarisgroup.com/api-reference/onboarding/businesses/business-identification-number/updatebusinessbin.md): Updates a business identification number record for a given business. Validation rules are consistent with the creation process; see the  Business Identification Number schema for details.
Duplicate entries (same business and number) are not allowed.