---
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 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.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)