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"
      }
    ]
  }
}