Enterprises

List enterprises

Changed on

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

get/enterprises

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/enterprises
  • Auth: HTTP bearer

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.

filter[role_type]'enterprise' | 'bpo'
Example:bpo

Only return enterprises of this type: bpo for call-center (BPO) enterprises, enterprise for normal enterprises. Omit to return both.

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",
      "bpo_verification_status": "approved",
      "bpo_verification_rejection_reason": "Business registration document could not be verified."
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 42,
    "page_number": 1,
    "page_size": 20
  }
}

Changes

  • 27a8076ac294Revision changes
    • warning

      added the new bpo enum value to the // response property for the response status

    • warning

      added the new enterprise enum value to the // response property for the response status

    • info

      added the new optional query request parameter filter[role_type]

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status