---
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

---

[API](https://skmtc.net/twilio/apis/numbers-v1.md) · [All operations](https://skmtc.net/twilio/apis/numbers-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/numbers-v1/versions/6e03a6a50c9d/schema)