Sign in

v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Enterprises

Replace an enterprise

Replace the enterprise's mutable fields. Only mutable fields may be sent. Server-assigned and immutable fields (id, record_type, created_at, updated_at, status fields, organization_type, country_code, role_type) cannot be changed: including any of them in the body is rejected with 400 Bad Request (Field 'X' is not allowed in this request).

put/enterprises/{enterprise_id}

Path parameters

enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

corporate_registration_numberstring nullable
customer_referencestring
doing_business_asstring
dun_bradstreet_numberstring nullable
feinstring
industry'accounting' | 'finance' | 'billing' | 'collections' | 'business' | 'charity' | 'nonprofit' | 'communications' | 'telecom' | 'customer service' | 'support' | 'delivery' | 'shipping' | 'logistics' | 'education' | 'financial' | 'banking' | 'government' | 'public' | 'healthcare' | 'health' | 'pharmacy' | 'medical' | 'insurance' | 'legal' | 'law' | 'notifications' | 'scheduling' | 'real estate' | 'property' | 'retail' | 'ecommerce' | 'sales' | 'marketing' | 'software' | 'technology' | 'tech' | 'media' | 'surveys' | 'market research' | 'travel' | 'hospitality' | 'hotel'
jurisdiction_of_incorporationstring

Updated state/province/country of incorporation. Optional on update.

legal_namestring

Legal name of the enterprise.

number_of_employeesstring
organization_legal_typestring
primary_business_domain_sic_codestring nullable
professional_license_numberstring nullable
websitestring uri

Example request

{
  "billing_address": {
    "administrative_area": "IL",
    "city": "Chicago",
    "country": "US",
    "extended_address": "Suite 504",
    "postal_code": "60601",
    "street_address": "100 Main St"
  },
  "billing_contact": {
    "email": "billing@acmeplumbing.example.com",
    "first_name": "Alex",
    "last_name": "Bill",
    "phone_number": "+13125550001"
  },
  "jurisdiction_of_incorporation": "Delaware",
  "organization_contact": {
    "email": "sam@acmeplumbing.example.com",
    "first_name": "Sam",
    "job_title": "Compliance Lead",
    "last_name": "Org",
    "phone_number": "+13125550000"
  },
  "organization_physical_address": {
    "administrative_area": "IL",
    "city": "Chicago",
    "country": "US",
    "extended_address": "Suite 504",
    "postal_code": "60601",
    "street_address": "100 Main St"
  }
}

Response

Enterprise updated.

Example response

{
  "data": {
    "billing_address": {
      "administrative_area": "IL",
      "city": "Chicago",
      "country": "US",
      "extended_address": "Suite 504",
      "postal_code": "60601",
      "street_address": "100 Main St"
    },
    "billing_contact": {
      "email": "billing@acmeplumbing.example.com",
      "first_name": "Alex",
      "last_name": "Bill",
      "phone_number": "+13125550001"
    },
    "country_code": "US",
    "created_at": "2026-04-26T18:06:51.940749Z",
    "customer_reference": "internal-id-12345",
    "doing_business_as": "Acme Plumbing",
    "fein": "12-3456789",
    "id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "industry": "technology",
    "jurisdiction_of_incorporation": "Delaware",
    "legal_name": "Acme Plumbing LLC",
    "number_of_employees": "51-200",
    "organization_contact": {
      "email": "sam@acmeplumbing.example.com",
      "first_name": "Sam",
      "job_title": "Compliance Lead",
      "last_name": "Org",
      "phone_number": "+13125550000"
    },
    "organization_legal_type": "llc",
    "organization_physical_address": {
      "administrative_area": "IL",
      "city": "Chicago",
      "country": "US",
      "extended_address": "Suite 504",
      "postal_code": "60601",
      "street_address": "100 Main St"
    },
    "organization_type": "commercial",
    "role_type": "enterprise",
    "updated_at": "2026-04-26T18:09:24.785211Z",
    "website": "https://acmeplumbing.example.com"
  }
}