---
title: "Create a bulk eligibility check for a set of numbers that you want to host in Twilio."
method: POST
path: "/v1/HostedNumber/Eligibility/Bulk"
tags: ["NumbersV1BulkEligibility"]
---

# Create a bulk eligibility check for a set of numbers that you want to host in Twilio.

`POST /v1/HostedNumber/Eligibility/Bulk`

Create a bulk eligibility check for a set of numbers that you want to host in Twilio.

## Request body

- object

## Response `202`

Accepted

- NumbersV1BulkEligibility
  - `request_id` string, nullable — The SID of the bulk eligibility check that you want to know about.
  - `url` string, uri, nullable — This is the url of the request that you're trying to reach out to locate the resource.
  - `results` unknown[], nullable — The result set that contains the eligibility check response for each 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, 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
  - `friendly_name` string, nullable — This is the string that you assigned as a friendly name for describing the eligibility check request.
  - `status` string, nullable — This is the status of the bulk eligibility check request. (Example: COMPLETE, IN_PROGRESS)
  - `date_created` string, date-time, nullable
  - `date_completed` string, date-time, nullable

## Changes

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

[Change history](https://skmtc.dev/twilio/apis/twilio-numbers/changes/v1/HostedNumber/Eligibility/Bulk/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)