Business Entities
Individual Entities
Documents
Entity Documents
Accounts
Counterparties
Counterparty Lookup
Mobile Money Transfers
Issuers
curl --request POST \
--url https://api.nuvion.tech/business-entities \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Acme Corporation",
"parent_relationship": "subsidiary",
"business": {
"website": "https://acmecorp.com",
"trade_name": "Acme",
"type": "LLC",
"industry": "Technology",
"legal_name": "Acme Corporation LLC",
"registration_number": "REG123456789",
"description": "A leading provider of innovative technology solutions",
"incorporation_meta": {
"year": 2020,
"month": 4,
"country": "US",
"state": "California"
}
},
"address": {
"line_1": "123 Tech Drive",
"line_2": "Suite 500",
"country_code": "US",
"city": "San Francisco",
"state": "California",
"postal_code": "94105"
},
"business_officers": [
{
"is_control_person": true,
"is_beneficial_owner": true,
"ownership_percentage": 60,
"job_title": "Chief Executive Officer",
"person": {
"first_name": "Jane",
"last_name": "Smith",
"middle_name": "Marie",
"date_of_birth": "1985-05-15",
"email": "[email protected]",
"nationality": "US",
"gender": "f",
"address": {
"line_1": "456 Oak Street",
"line_2": "Apt 303",
"country_code": "US",
"city": "San Francisco",
"state": "California",
"postal_code": "94107"
},
"identification": {
"drivers_license": {
"number": "DL123456789",
"issuing_country": "US",
"issue_date": "2018-01-15",
"expiry_date": "2026-01-14",
"urls": {
"main": "https://storage.example.com/documents/dl-front-123.jpg",
"back": "https://storage.example.com/documents/dl-back-123.jpg"
}
}
}
}
},
{
"is_control_person": false,
"is_beneficial_owner": true,
"ownership_percentage": 40,
"job_title": "Chief Financial Officer",
"person": {
"first_name": "Michael",
"last_name": "Johnson",
"date_of_birth": "1982-09-23",
"email": "[email protected]",
"nationality": "US",
"gender": "m",
"address": {
"line_1": "789 Pine Avenue",
"country_code": "US",
"city": "San Francisco",
"state": "California",
"postal_code": "94109"
},
"identification": {
"national_id": {
"type": "SSN",
"value": "123-45-6789",
"urls": {
"main": "https://storage.example.com/documents/ssn-123.jpg"
}
}
}
}
}
]
}
'{
"message": "Business entity created successfully",
"status": 201,
"data": {
"entity": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F3",
"type": "business",
"status": "approved",
"name": "Acme Corporation",
"is_root": true,
"parent_entity": "01HJ5G6R7MXW5ZK2QD6YA8N9F4",
"parent_relationship": "subsidiary",
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"user_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F6",
"creation_context": "user",
"risk_score": null,
"sanctions_status": null,
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"address": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F7",
"line_1": "123 Tech Drive",
"line_2": "Suite 500",
"line_3": null,
"city": "San Francisco",
"state": "California",
"postal_code": "94105",
"country_code": "US",
"owner_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"owner_type": "business",
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"business": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"legal_name": "Acme Corporation LLC",
"trade_name": "Acme",
"registration_number": "REG123456789",
"industry": "Technology",
"website": "https://acmecorp.com",
"type": "LLC",
"description": "A leading provider of innovative technology solutions",
"incorporation_meta": {
"year": 2020,
"month": 4,
"country": "US",
"state": "California"
},
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"business_meta": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F8",
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"meta": {
"tax_id": "123-45-6789"
},
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"business_officers": [
{
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F9",
"person_id": "01HJ5G6R7MXW5ZK2QD6YA8N9G1",
"job_title": "Chief Executive Officer",
"is_control_person": true,
"is_beneficial_owner": true,
"ownership_percentage": 60,
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
{
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9G2",
"person_id": "01HJ5G6R7MXW5ZK2QD6YA8N9G3",
"job_title": "Chief Financial Officer",
"is_control_person": false,
"is_beneficial_owner": true,
"ownership_percentage": 40,
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
}
]
}
}Create a Business Entity
Creates a new business entity for the authenticated user or entity.
curl --request POST \
--url https://api.nuvion.tech/business-entities \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Acme Corporation",
"parent_relationship": "subsidiary",
"business": {
"website": "https://acmecorp.com",
"trade_name": "Acme",
"type": "LLC",
"industry": "Technology",
"legal_name": "Acme Corporation LLC",
"registration_number": "REG123456789",
"description": "A leading provider of innovative technology solutions",
"incorporation_meta": {
"year": 2020,
"month": 4,
"country": "US",
"state": "California"
}
},
"address": {
"line_1": "123 Tech Drive",
"line_2": "Suite 500",
"country_code": "US",
"city": "San Francisco",
"state": "California",
"postal_code": "94105"
},
"business_officers": [
{
"is_control_person": true,
"is_beneficial_owner": true,
"ownership_percentage": 60,
"job_title": "Chief Executive Officer",
"person": {
"first_name": "Jane",
"last_name": "Smith",
"middle_name": "Marie",
"date_of_birth": "1985-05-15",
"email": "[email protected]",
"nationality": "US",
"gender": "f",
"address": {
"line_1": "456 Oak Street",
"line_2": "Apt 303",
"country_code": "US",
"city": "San Francisco",
"state": "California",
"postal_code": "94107"
},
"identification": {
"drivers_license": {
"number": "DL123456789",
"issuing_country": "US",
"issue_date": "2018-01-15",
"expiry_date": "2026-01-14",
"urls": {
"main": "https://storage.example.com/documents/dl-front-123.jpg",
"back": "https://storage.example.com/documents/dl-back-123.jpg"
}
}
}
}
},
{
"is_control_person": false,
"is_beneficial_owner": true,
"ownership_percentage": 40,
"job_title": "Chief Financial Officer",
"person": {
"first_name": "Michael",
"last_name": "Johnson",
"date_of_birth": "1982-09-23",
"email": "[email protected]",
"nationality": "US",
"gender": "m",
"address": {
"line_1": "789 Pine Avenue",
"country_code": "US",
"city": "San Francisco",
"state": "California",
"postal_code": "94109"
},
"identification": {
"national_id": {
"type": "SSN",
"value": "123-45-6789",
"urls": {
"main": "https://storage.example.com/documents/ssn-123.jpg"
}
}
}
}
}
]
}
'{
"message": "Business entity created successfully",
"status": 201,
"data": {
"entity": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F3",
"type": "business",
"status": "approved",
"name": "Acme Corporation",
"is_root": true,
"parent_entity": "01HJ5G6R7MXW5ZK2QD6YA8N9F4",
"parent_relationship": "subsidiary",
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"user_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F6",
"creation_context": "user",
"risk_score": null,
"sanctions_status": null,
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"address": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F7",
"line_1": "123 Tech Drive",
"line_2": "Suite 500",
"line_3": null,
"city": "San Francisco",
"state": "California",
"postal_code": "94105",
"country_code": "US",
"owner_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"owner_type": "business",
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"business": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"legal_name": "Acme Corporation LLC",
"trade_name": "Acme",
"registration_number": "REG123456789",
"industry": "Technology",
"website": "https://acmecorp.com",
"type": "LLC",
"description": "A leading provider of innovative technology solutions",
"incorporation_meta": {
"year": 2020,
"month": 4,
"country": "US",
"state": "California"
},
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"business_meta": {
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F8",
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"meta": {
"tax_id": "123-45-6789"
},
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
"business_officers": [
{
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9F9",
"person_id": "01HJ5G6R7MXW5ZK2QD6YA8N9G1",
"job_title": "Chief Executive Officer",
"is_control_person": true,
"is_beneficial_owner": true,
"ownership_percentage": 60,
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
},
{
"id": "01HJ5G6R7MXW5ZK2QD6YA8N9G2",
"person_id": "01HJ5G6R7MXW5ZK2QD6YA8N9G3",
"job_title": "Chief Financial Officer",
"is_control_person": false,
"is_beneficial_owner": true,
"ownership_percentage": 40,
"business_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
"created": "2025-09-12T12:00:00.000Z",
"updated": "2025-09-12T12:00:00.000Z"
}
]
}
}Headers
Authorization header: Bearer {jwt or Secretkey}
Body
The name of the business entity
Business details
Show child attributes
Show child attributes
Business entity type
Business industry
Legal name of the business
Business registration number
Business description
Business incorporation metadata
Show child attributes
Show child attributes
Business website URL
Business trade name
The relationship with the parent entity
The ULID of the parent entity
Business address
Show child attributes
Show child attributes
List of business officers
Response
Created successfully
A descriptive message indicating the result of the operation
The status of the API operation (successful, error, failed, pending)
Container for the created business entity data
Show child attributes
Show child attributes
Core entity information
Show child attributes
Show child attributes
Unique identifier for the entity
Type of entity
Current status of the entity
Name of the entity
Indicates if this is a root entity
ID of the associated business
ID of the user who created the entity
Context in which the entity was created
Timestamp when the entity was created
Timestamp when the entity was last updated
ID of the parent entity if applicable
Type of relationship with the parent entity
Risk assessment score for the entity
Status of sanctions checks
Address information for the business entity
Show child attributes
Show child attributes
Unique identifier for the address
First line of the address
City name
State or province
Postal or ZIP code
Two-letter country code
ID of the entity that owns this address
Type of entity that owns this address
Timestamp when the address was created
Timestamp when the address was last updated
Second line of the address
Third line of the address
Business-specific information
Show child attributes
Show child attributes
Unique identifier for the business
Legal registered name of the business
Official registration number
Industry sector of the business
Type of business entity
Information about business incorporation
Show child attributes
Show child attributes
Year of incorporation
Month of incorporation
Country of incorporation
State or province of incorporation
Timestamp when the business record was created
Timestamp when the business record was last updated
Trading or doing-business-as name
Website URL of the business
Description of the business
Additional metadata for the business
Show child attributes
Show child attributes
Unique identifier for the metadata record
ID of the associated business
Timestamp when the metadata was created
Timestamp when the metadata was last updated
List of officers associated with the business
Show child attributes
Show child attributes
Unique identifier for the officer record
ID of the person who is the officer
Job title of the officer
Indicates if the officer has control over the business
Indicates if the officer is a beneficial owner
ID of the associated business
Timestamp when the officer record was created
Timestamp when the officer record was last updated
Percentage of ownership in the business