Sign in
Enterprises

List enterprises

Return the enterprises you own, paginated. The default page size is 20; the maximum is 250.

get/enterprises

Query parameters

page[number]integer
Example:1

1-based page number. Out-of-range values return an empty page with correct meta.

page[size]integer
Example:10

Items per page. Default 10. Maximum 250; values above are clamped to 250.

legal_namestring
Example:Acme

Filter by legal name (partial match).

filter[legal_name][contains]string
Example:Acme

Case-insensitive partial match on legal name.

Response

Paginated list of enterprises.

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"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 42,
    "page_number": 1,
    "page_size": 20
  }
}

Changes

Changed in 2 of the 47 revisions of this API.12141

  • 81ee1b2477a21See the full diff
    • ○

      added the new optional query request parameter filter[legal_name][contains]

      new-optional-request-parameter

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

  • 8a8c40f458c512140See the full diff
    • ▲

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

      response-property-max-length-unset

    • ▲

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

      response-property-max-length-unset

    • ▲

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

      response-property-max-length-unset

    • ▲

      the data/items/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/items/organization_physical_address/country response property's maxLength was unset from 100 for the response status 200

      response-property-max-length-unset

    • ▲

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

      response-property-type-changed

    • ▲

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

      response-required-property-removed

    • ▲

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

      response-required-property-removed

    • ▲

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

      response-required-property-removed

    • ▲

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

      response-required-property-removed

    • ▲

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

      response-required-property-removed

    • ▲

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

      response-required-property-removed

    • ●

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

      response-optional-property-removed

    • ○

      api operation id ListEnterprises removed and replaced with listEnterprises

      api-operation-id-removed

    • ○

      for the query request parameter page[size], the max was increased from 100.00 to 250.00

      request-parameter-max-increased

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

      added the optional property data/items/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_ids 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 401 status

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-became-read-only

    • ○

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

      response-optional-property-became-read-only

    • ○

      the response optional property data/items/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/items/detail became required for the status 401

      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/url became required for the status 401

      response-property-became-required

    • ○

      the response property meta became required for the status 200

      response-property-became-required

    • ○

      the response property meta/page_number became required for the status 200

      response-property-became-required

    • ○

      the response property meta/page_size became required for the status 200

      response-property-became-required

    • ○

      the response property meta/total_pages became required for the status 200

      response-property-became-required

    • ○

      the response property meta/total_results became required for the status 200

      response-property-became-required

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

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

      response-property-enum-value-removed

    • ○

      added the required property data/items/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