Sign in
Enterprises

Get an enterprise

Retrieve a single enterprise by id. Returns 404 if the id does not exist or does not belong to your account.

get/enterprises/{enterprise_id}

Path parameters

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

The enterprise id. Lowercase UUID.

Response

Enterprise.

Example response

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

Changes

Changed in 1 of the 47 revisions of this API.12142

  • 8a8c40f458c512142See the full diff
    • ▲

      the data/billing_contact/email response property's maxLength was unset from 255 for the response status 200

      response-property-max-length-unset

    • ▲

      the data/billing_contact/phone_number response property's maxLength was unset from 20 for the response status 200

      response-property-max-length-unset

    • ▲

      the data/organization_contact/email response property's maxLength was unset from 255 for the response status 200

      response-property-max-length-unset

    • ▲

      the data/organization_physical_address/administrative_area response property's maxLength was unset from 100 for the response status 200

      response-property-max-length-unset

    • ▲

      the data/organization_physical_address/country response property's maxLength was unset from 100 for the response status 200

      response-property-max-length-unset

    • ▲

      the data/billing_address response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ▲

      removed the required property data/billing_address/administrative_area from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/billing_address/city from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/billing_address/country from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/billing_address/postal_code from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/billing_address/street_address from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property data/organization_contact/phone from the response with the 200 status

      response-required-property-removed

    • ●

      removed the optional property data/billing_address/extended_address from the response with the 200 status

      response-optional-property-removed

    • ○

      api operation id GetEnterprise removed and replaced with getEnterprise

      api-operation-id-removed

    • ○

      added the optional property data/branded_calling_enabled to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/jurisdiction_of_incorporation to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/number_reputation_enabled to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/pending_check_codes to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/pending_check_codes to the response with the 404 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/pending_check_ids to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/pending_check_ids to the response with the 404 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/pending_check_labels to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/pending_check_labels to the response with the 404 status

      response-optional-property-added

    • ○

      added the optional property errors/items/source/parameter to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property errors/items/source/parameter to the response with the 404 status

      response-optional-property-added

    • ○

      the response optional property data/created_at became read-only for the status 200

      response-optional-property-became-read-only

    • ○

      the response optional property data/id became read-only for the status 200

      response-optional-property-became-read-only

    • ○

      the response optional property data/updated_at became read-only for the status 200

      response-optional-property-became-read-only

    • ○

      the response property data became required for the status 200

      response-property-became-required

    • ○

      the response property errors became required for the status 401

      response-property-became-required

    • ○

      the response property errors became required for the status 404

      response-property-became-required

    • ○

      the response property errors/items/detail became required for the status 401

      response-property-became-required

    • ○

      the response property errors/items/detail became required for the status 404

      response-property-became-required

    • ○

      the response property errors/items/meta became required for the status 401

      response-property-became-required

    • ○

      the response property errors/items/meta became required for the status 404

      response-property-became-required

    • ○

      the response property errors/items/meta/url became required for the status 401

      response-property-became-required

    • ○

      the response property errors/items/meta/url became required for the status 404

      response-property-became-required

    • ○

      removed the 1-10 enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 10001+ enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 11-50 enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 2001-10000 enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 201-500 enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 501-2000 enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the 51-200 enum value from the data/number_of_employees response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the bpo enum value from the data/role_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the commercial enum value from the data/organization_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the corporation enum value from the data/organization_legal_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the enterprise enum value from the data/role_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the government enum value from the data/organization_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the llc enum value from the data/organization_legal_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the non_profit enum value from the data/organization_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the nonprofit enum value from the data/organization_legal_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the other enum value from the data/organization_legal_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the partnership enum value from the data/organization_legal_type response property for the response status 200

      response-property-enum-value-removed

    • ○

      added the required property data/organization_contact/phone_number to the response with the 200 status

      response-required-property-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog