---
title: "Check hosted messaging eligibility"
method: POST
path: "/messaging_hosted_number_orders/eligibility_numbers_check"
tags: ["Hosted Numbers"]
---

# Check hosted messaging eligibility

`POST /messaging_hosted_number_orders/eligibility_numbers_check`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/messaging_hosted_number_orders/eligibility_numbers_check`
- Auth: HTTP bearer

Checks whether the supplied phone numbers are eligible for hosted messaging before an order is created.

## Request body

- EligibilityNumbersRequest
  - `phone_numbers` string[], required: List of phone numbers to check eligibility

## Response `200`

Successful response

- EligibilityNumbersResponse
  - `phone_numbers` EligibilityNumberResponse[]: List of phone numbers with their eligibility status.
    - `detail` string: Detailed information about the eligibility status.
    - `phone_number` string: The phone number in e164 format.
    - `eligible` boolean: Whether the phone number is eligible for hosted messaging.
    - `eligible_status` 'NUMBER_CAN_NOT_BE_REPEATED' | 'NUMBER_CAN_NOT_BE_VALIDATED' | 'NUMBER_CAN_NOT_BE_WIRELESS' | 'NUMBER_CAN_NOT_BE_ACTIVE_IN_YOUR_ACCOUNT' | 'NUMBER_CAN_NOT_HOSTED_WITH_A_TELNYX_SUBSCRIBER' | 'NUMBER_CAN_NOT_BE_IN_TELNYX' | 'NUMBER_IS_NOT_A_US_NUMBER' | 'NUMBER_IS_NOT_A_VALID_ROUTING_NUMBER' | 'NUMBER_IS_NOT_IN_E164_FORMAT' | 'BILLING_ACCOUNT_CHECK_FAILED' | 'BILLING_ACCOUNT_IS_ABOLISHED' | 'ELIGIBLE': The eligibility status of the phone number.

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

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