---
title: "List enterprises"
method: GET
path: "/enterprises"
tags: ["Enterprises"]
---

# List enterprises

`GET /enterprises`

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

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `legal_name` string
- `filter[legal_name][contains]` string

## Response `200`

Paginated list of enterprises.

- EnterpriseListPublic
  - `data` EnterprisePublic[], required
    - `billing_address` BillingAddress
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `extended_address` string, nullable
      - `postal_code` string, required
      - `street_address` string, required
    - `billing_contact` BillingContact
      - `email` string, email, required
      - `first_name` string, required
      - `last_name` string, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `branded_calling_enabled` boolean — True once Branded Calling has been activated on this enterprise (see `POST /enterprises/{id}/branded_calling`).
    - `corporate_registration_number` string, nullable — Optional corporate-registration / company-number identifier.
    - `country_code` string
    - `created_at` string, date-time
    - `customer_reference` string
    - `doing_business_as` string
    - `dun_bradstreet_number` string, nullable — Optional D-U-N-S Number issued by Dun & Bradstreet.
    - `fein` string
    - `id` string, uuid
    - `industry` string
    - `jurisdiction_of_incorporation` string
    - `legal_name` string
    - `number_of_employees` string
    - `number_reputation_enabled` boolean — True once Phone Number Reputation has been enabled on this enterprise (see `POST /enterprises/{id}/reputation`).
    - `organization_contact` OrganizationContact
      - `email` string, email, required
      - `first_name` string, required
      - `job_title` string, required
      - `last_name` string, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `organization_legal_type` string
    - `organization_physical_address` PhysicalAddress
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `extended_address` string, nullable
      - `postal_code` string, required
      - `street_address` string, required
    - `organization_type` string
    - `primary_business_domain_sic_code` string, nullable — Optional SIC code for the primary line of business.
    - `professional_license_number` string, nullable — Optional professional-license number for regulated industries.
    - `role_type` string
    - `updated_at` string, date-time
    - `website` string
  - `meta` BrandedCallingPaginationMeta, required — JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `page_number` integer, required — 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required — Number of items returned in this page's `data` array. Capped at 250.
    - `total_pages` integer, required — Total number of pages available given the current `page_size`.
    - `total_results` integer, required — Total number of items across all pages (excludes soft-deleted rows).

## Other responses

- `401` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/ec31f78cf002/schema)