---
title: "List messaging hosted numbers"
method: GET
path: "/messaging/hosted/numbers"
tags: ["Messaging"]
---

# List messaging hosted numbers

`GET /messaging/hosted/numbers`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/messaging/hosted/numbers`
- Auth: HTTP bearer

List all hosted numbers associated with the authenticated user.

## Query parameters

- `filter[messaging_profile_id]` string, uuid
- `filter[phone_number]` string
- `filter[phone_number][contains]` string
- `sort[phone_number]` 'asc' | 'desc'
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response with a list of hosted numbers.

- object
  - `data` PhoneNumberWithMessagingSettings[]
    - `record_type` 'messaging_phone_number' | 'messaging_settings': Identifies the type of the resource.
    - `id` string: Identifies the type of resource.
    - `phone_number` string: +E.164 formatted phone number.
    - `messaging_profile_id` string, nullable: Unique identifier for a messaging profile.
    - `created_at` string, date-time: ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string, date-time: ISO 8601 formatted date indicating when the resource was updated.
    - `country_code` string: ISO 3166-1 alpha-2 country code.
    - `type` 'long-code' | 'toll-free' | 'short-code' | 'longcode' | 'tollfree' | 'shortcode': The type of the phone number
    - `health` NumberHealthMetrics: High level health metrics about the number and it's messaging sending patterns.
      - `message_count` integer, required: The number of messages analyzed for the health metrics.
      - `inbound_outbound_ratio` number, float, required: The ratio of messages received to the number of messages sent.
      - `success_ratio` number, float, required: The ratio of messages sucessfully delivered to the number of messages attempted.
      - `spam_ratio` number, float, required: The ratio of messages blocked for spam to the number of messages attempted.
    - `eligible_messaging_products` string[]: The messaging products that this number can be registered to use
    - `traffic_type` string: The messaging traffic or use case for which the number is currently configured.
    - `messaging_product` string: The messaging product that the number is registered to use
    - `features` object
      - `sms` MessagingFeatureSet, nullable: The set of features available for a specific messaging use case (SMS or MMS). Features can vary depending on the characteristics the phone number, as well as its current product configuration.
        - `domestic_two_way` boolean, required: Send messages to and receive messages from numbers in the same country.
        - `international_inbound` boolean, required: Receive messages from numbers in other countries.
        - `international_outbound` boolean, required: Send messages to numbers in other countries.
      - `mms` MessagingFeatureSet, nullable: The set of features available for a specific messaging use case (SMS or MMS). Features can vary depending on the characteristics the phone number, as well as its current product configuration.
        - `domestic_two_way` boolean, required: Send messages to and receive messages from numbers in the same country.
        - `international_inbound` boolean, required: Receive messages from numbers in other countries.
        - `international_outbound` boolean, required: Send messages to numbers in other countries.
    - `organization_id` string: The organization that owns this phone number.
    - `tags` string[]: Tags associated with this phone number.
  - `meta` MessagingPaginationMeta
    - `total_pages` integer, required
    - `total_results` integer, required
    - `page_number` integer, required
    - `page_size` integer, required

## Other responses

- `401`: Unauthorized

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/messaging/hosted/numbers/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)