---
title: "Create an eligibility check for a number that you want to host in Twilio."
method: POST
path: "/v1/HostedNumber/Eligibility"
tags: ["NumbersV1Eligibility"]
---

# Create an eligibility check for a number that you want to host in Twilio.

`POST /v1/HostedNumber/Eligibility`

Create an eligibility check for a number that you want to host in Twilio.

## Request body

- object

## Response `200`

OK

- NumbersV1Eligibility
  - `results` unknown[], nullable — The result set that contains the eligibility check response for the requested number, each result has at least the following attributes: phone_number: The requested phone number ,hosting_account_sid: The account sid where the phone number will be hosted, date_last_checked: Datetime (ISO 8601) when the PN was last checked for eligibility, country: Phone number’s country, eligibility_status: Indicates the eligibility status of the PN (Eligible/Ineligible), eligibility_sub_status: Indicates the sub status of the eligibility , ineligibility_reason: Reason for number's ineligibility (if applicable), next_step: Suggested next step in the hosting process based on the eligibility status.
    - unknown

## Changes

- **2025-07-03** (v1) `2d7d1abf6287` — 1 breaking
  - the `results/items/` response's property type changed from `object` to no type for status `200`
- **2025-03-11** (v1) `e0028979b138` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2024-06-18** (v1) `9e7f590e84be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/twilio/apis/twilio-numbers/changes/v1/HostedNumber/Eligibility/post.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-numbers.md) · [All operations](https://skmtc.dev/twilio/apis/twilio-numbers/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-numbers/revisions/47965226105d?raw)