---
title: "Fetch an eligibility bulk check that you requested to host in Twilio."
method: GET
path: "/v1/HostedNumber/Eligibility/Bulk/{RequestId}"
tags: ["NumbersV1BulkEligibility"]
---

# Fetch an eligibility bulk check that you requested to host in Twilio.

`GET /v1/HostedNumber/Eligibility/Bulk/{RequestId}`

Fetch an eligibility bulk check that you requested to host in Twilio.

## Path parameters

- `RequestId` string, required

## Response `200`

OK

- 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/twilio-numbers.md) · [All operations](https://skmtc.net/twilio/apis/twilio-numbers/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-numbers/revisions/089dd6360dfe/schema)