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

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/numbers_v1/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"numbers_v1 MCP server": {
  "url": "https://twilio.demo.bump-doc.com/doc/numbers_v1/mcp"
}
Close
GET /v1/HostedNumber/Eligibility/Bulk/{RequestId}

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

Path parameters

  • RequestId string Required

    The SID of the bulk eligibility check that you want to know about.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^EC[0-9a-fA-F]{32}$.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • request_id string | null

      The SID of the bulk eligibility check that you want to know about.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^EC[0-9a-fA-F]{32}$.

    • url string(uri) | null

      This is the url of the request that you're trying to reach out to locate the resource.

    • results array | null

      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.

    • friendly_name string | null

      This is the string that you assigned as a friendly name for describing the eligibility check request.

    • status string | null

      This is the status of the bulk eligibility check request. (Example: COMPLETE, IN_PROGRESS)

    • date_created string(date-time) | null
    • date_completed string(date-time) | null
GET /v1/HostedNumber/Eligibility/Bulk/{RequestId}
curl \
 --request GET 'https://numbers.twilio.com/v1/HostedNumber/Eligibility/Bulk/{RequestId}' \
 --user "username:password"
Response examples (200)
{
  "friendly_name": "Foo",
  "status": "SUCCESSFUL",
  "date_created": "2023-04-24T14:47:04Z",
  "date_completed": "2023-04-24T14:47:06Z",
  "results": [
    {
      "phone_number": "+18778894546",
      "account_sid": "AC93b447ff5bd2abac37f1cbab2a871430",
      "eligibility_status": "INELIGIBLE",
      "eligibility_sub_status": "ALREADY_IN_TWILIO",
      "ineligibility_reason": "ALREADY_IN_TWILIO_BUT_NOT_IN_USE",
      "next_step": "CONTACT_SUPPORT_INELIGIBLE_INVENTORY_STATUS",
      "voice_provider": null,
      "messaging_provider": null,
      "phone_number_type": "TOLL_FREE",
      "hosting_order_sid": null,
      "hosting_order_status": null,
      "iso_country_code": "US",
      "inventory_status": "in-testing",
      "inventory_account_sid": "AC93b447ff5bd2abac37f1cbab2a871430"
    }
  ],
  "url": "https://numbers.twilio.com/v1/HostedNumber/Eligibility/Bulk/ECaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "request_id": "ECaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}