> ## Documentation Index > Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search Available Numbers > Search for phone numbers available to purchase, filtered by country, type, or area code. **Legacy endpoint - deprecated.** Unversioned endpoints are scheduled for removal on **July 31, 2026**. Use the [`/v1` version](/docs/api-reference/v1/phone-numbers/search-plivo) for new integrations. This endpoint remains available for existing integrations until then. Searches your telephony provider for available phone numbers that you can purchase. Filter by country, area code, or number type to find what you need. The response includes the monthly rental cost and capabilities (voice, SMS) for each number. ## Query parameters | Parameter | Description | | -------------- | ----------------------------------------------------------------------------- | | `country_code` | ISO 3166-1 alpha-2 country code, e.g. `IN` for India, `US` for United States. | | `area_code` | Filter by area code or number prefix. | | `number_type` | `local`, `toll-free`, or `mobile`. | | `limit` | Max results to return (default 20). | ## Tip Once you find a number you want, pass it to [Purchase a Number](/docs/api-reference/v1/phone-numbers/buy) to add it to your account. ## OpenAPI ````yaml GET /organization-phone-numbers/provider-numbers openapi: 3.0.0 info: title: DialNexa API description: >- Public REST API for the DialNexa voice AI platform. Versioned endpoints are under /v1; unversioned endpoints are legacy and deprecated. version: 1.0.0 servers: - url: https://api.dialnexa.com description: DialNexa production API security: - bearer: [] tags: - name: API Keys - name: Agent Functions - name: Agents V1 - name: Agents2 - name: Batch Calls - name: Batch Calls V1 - name: Call Logs - name: Calls - name: Calls V1 - name: Campaign Leads - name: Campaigns - name: External Webhooks - name: Knowledge Base - name: Knowledge Base V1 - name: LLMs - name: LLMs V1 - name: Languages - name: Languages V1 - name: Organization Phone Numbers - name: Organization Phone Numbers V1 - name: Phone Number Pricing - name: Phone Number Pricing V1 - name: Transcribers - name: Transcribers V1 - name: User Webhooks - name: User Webhooks V1 - name: V1 - name: Voices - name: Voices V1 - name: Webcall - name: Workflow Leads - name: Workflow Leads V1 - name: Workflows - name: Workflows V1 paths: /organization-phone-numbers/provider-numbers: get: tags: - Organization Phone Numbers summary: Get available phone numbers from the specified provider description: >- **Legacy endpoint - deprecated, scheduled for removal on July 31, 2026.** Use the `/v1` version for new integrations. Unified endpoint for retrieving available phone numbers from either Plivo or Twilio. Determines which provider to use from telephony_provider_id (1=Plivo, 2=Twilio), always requests the 'local' number type (formatted per-provider - 'local' for Plivo, 'Local' for Twilio), and returns a consistent response format regardless of provider. operationId: OrganizationPhoneNumbersController_getProviderPhoneNumbers parameters: - name: country_iso required: true in: query description: ISO country code (e.g., US, GB, CA) schema: example: US type: string - name: telephony_provider_id required: true in: query description: ID of telephony provider (14-char string) schema: example: prov_plivo_123456 type: string - name: region required: false in: query description: Region/state to filter numbers by schema: example: Karnataka type: string - name: x-organization-id in: header description: RSA-encrypted organization_id string (base64 format) required: true schema: type: string responses: '200': description: Available phone numbers retrieved successfully content: application/json: schema: $ref: '#/components/schemas/GetProviderPhoneNumbersResponseDto' '400': description: Invalid request or failed to retrieve numbers deprecated: true components: schemas: GetProviderPhoneNumbersResponseDto: type: object properties: telephonyProviderId: type: string description: ID of telephony provider (14-char string) providerName: type: string description: Provider name (Plivo or Twilio) data: description: Phone numbers data from the provider oneOf: - $ref: '#/components/schemas/PlivoPhoneNumbersResponseDto' - $ref: '#/components/schemas/TwilioPhoneNumbersResponseDto' required: - telephonyProviderId - providerName - data PlivoPhoneNumbersResponseDto: type: object properties: api_id: type: string description: API ID for the request objects: description: List of available phone numbers type: array items: $ref: '#/components/schemas/PlivoPhoneNumberDto' meta: type: object description: Total count of available numbers required: - api_id - objects - meta TwilioPhoneNumbersResponseDto: type: object properties: available_phone_numbers: description: List of available phone numbers type: array items: $ref: '#/components/schemas/TwilioPhoneNumberDto' uri: type: string description: URI for the resource required: - available_phone_numbers - uri PlivoPhoneNumberDto: type: object properties: number: type: string description: The phone number type: type: string description: The type of phone number (local, tollfree, etc.) monthly_rental_rate: type: string description: The monthly rental rate for the phone number setup_rate: type: string description: The setup fee for the phone number voice_enabled: type: boolean description: Voice capability of the phone number sms_enabled: type: boolean description: SMS capability of the phone number mms_enabled: type: boolean description: MMS capability of the phone number country_iso: type: string description: Country ISO code number_format: type: string description: The number in international format required: - number - type - monthly_rental_rate - setup_rate - voice_enabled - sms_enabled - mms_enabled - country_iso - number_format TwilioPhoneNumberDto: type: object properties: phone_number: type: string description: The phone number friendly_name: type: string description: The friendly name of the phone number iso_country: type: string description: Country ISO code capabilities: description: Capabilities of the phone number allOf: - $ref: '#/components/schemas/TwilioPhoneNumberCapabilitiesDto' required: - phone_number - friendly_name - iso_country - capabilities TwilioPhoneNumberCapabilitiesDto: type: object properties: voice: type: boolean description: Voice capability of the phone number SMS: type: boolean description: SMS capability of the phone number MMS: type: boolean description: MMS capability of the phone number required: - voice - SMS - MMS securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````