Skip to main content
GET
/
enterprises
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const enterprisePublic of client.enterprises.list()) {
  console.log(enterprisePublic.id);
}
{
  "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",
      "primary_business_domain_sic_code": null,
      "corporate_registration_number": null,
      "professional_license_number": null,
      "dun_bradstreet_number": null,
      "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",
      "branded_calling_enabled": true,
      "number_reputation_enabled": true
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 42,
    "page_number": 1,
    "page_size": 20
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page[number]
integer
default:1

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

Required range: x >= 1
Example:

1

​
page[size]
integer
default:10

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

Required range: 1 <= x <= 250
Example:

10

​
legal_name
string

Filter by legal name (partial match).

Example:

"Acme"

​
filter[legal_name][contains]
string

Case-insensitive partial match on legal name.

Example:

"Acme"

Response

Paginated list of enterprises.

​
data
object[]
required
​
meta
object
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.