> ## Documentation Index > Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search purchasable business phone numbers > Searches available phone numbers for purchase, applying country, area, and capability filters for lead communication setup. ## OpenAPI ````yaml /openapi.json post /phone-numbers/search openapi: 3.0.4 info: title: Leadping API description: >- Leadping API for lead intake, messaging, calling, automations, billing, business settings, and compliant lead communication workflows. license: name: MIT url: https://opensource.org/licenses/MIT version: v1 servers: - url: https://api.leadping.ai description: Production security: [] tags: - name: Analytics - name: Automations - name: Contact - name: Conversations - name: Dispositions - name: Feedback - name: Leads - name: LeadStatuses - name: Notifications - name: OutboundDelivery - name: Sources - name: Suppressions - name: Tags - name: Users - name: Calls - name: PhoneNumbers - name: Sms - name: Telephony - name: UserDataExports - name: CallEvents - name: Events - name: SmsEvents - name: Businesses - name: PaymentMethods - name: Transactions - name: Usage - name: Wallets paths: /phone-numbers/search: post: tags: - PhoneNumbers summary: Search purchasable business phone numbers description: >- Searches available phone numbers for purchase, applying country, area, and capability filters for lead communication setup. operationId: PhoneNumbers_Search requestBody: description: Used to signal cancellation of the operation if needed. content: application/json: schema: allOf: - $ref: '#/components/schemas/PhoneNumberSearchRequest' description: >- Request schema for the Leadping API phone number search request, including the fields clients can send. application/*+json: schema: allOf: - $ref: '#/components/schemas/PhoneNumberSearchRequest' description: >- Request schema for the Leadping API phone number search request, including the fields clients can send. required: true responses: '200': description: Returns the phone number search response. content: application/json: schema: allOf: - $ref: '#/components/schemas/PhoneNumberSearchResponse' description: >- Response schema for the Leadping API phone number search response returned to authenticated clients. '400': description: The request was invalid or failed validation. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: An unexpected server error occurred. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' components: schemas: PhoneNumberSearchRequest: type: object properties: phoneNumber: type: string description: >- Phone number used by this phone number search request for calls, SMS, lookup, or routing. nullable: true location: type: object allOf: - $ref: '#/components/schemas/PhoneNumberLocation' description: >- Geographic location metadata for the phone number, lead, or lookup result. nullable: true description: >- Request schema for the Leadping API phone number search request, including the fields clients can send. PhoneNumberSearchResponse: type: object properties: numbers: type: array items: allOf: - $ref: '#/components/schemas/PhoneNumberSearchResult' description: >- Result schema for the Leadping API phone number search result returned by lookup and validation endpoints. description: >- Phone numbers returned or evaluated by this phone number search response. description: >- Response schema for the Leadping API phone number search response returned to authenticated clients. ProblemDetails: type: object properties: type: type: string description: URI reference that identifies the problem type. nullable: true title: type: string description: Short, human-readable summary of the problem. nullable: true status: pattern: ^-?(?:0|[1-9]\d*)$ description: HTTP status code returned for the problem. format: int32 nullable: true detail: type: string description: >- Human-readable explanation specific to this occurrence of the problem. nullable: true instance: type: string description: >- URI reference that identifies this specific occurrence of the problem. nullable: true PhoneNumberLocation: type: object properties: location: type: string description: >- Geographic location metadata for the phone number, lead, or lookup result. nullable: true state: type: string description: State, province, or region for the lead or business postal address. nullable: true canonicalCity: type: string description: >- Canonical city resolved by Leadping from its ZIP-code geography data. nullable: true canonicalState: type: string description: Canonical state or territory abbreviation resolved by Leadping. nullable: true countryCode: type: string description: >- Country code for the phone number or location represented by this phone number location. nullable: true coordinate: type: object allOf: - $ref: '#/components/schemas/Coordinate' description: Latitude and longitude coordinate for this phone number location. nullable: true coordinateSource: type: object allOf: - $ref: '#/components/schemas/PhoneLocationSource' description: Describes how the coordinate was resolved. nullable: true timeZoneId: type: string description: >- IANA or Windows time zone identifier used for local scheduling and reporting. nullable: true timeZoneSource: type: object allOf: - $ref: '#/components/schemas/PhoneLocationSource' description: Describes how the time zone was resolved. nullable: true description: Public Leadping API schema for phone number location data. PhoneNumberSearchResult: type: object properties: number: type: string description: E.164 phone number exposed by this phone number search result. location: type: object allOf: - $ref: '#/components/schemas/PhoneNumberLocation' description: >- Geographic location metadata for the phone number, lead, or lookup result. nullable: true description: >- Result schema for the Leadping API phone number search result returned by lookup and validation endpoints. Coordinate: required: - latitude - longitude type: object properties: latitude: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$ description: >- Latitude of the geographic coordinate in decimal degrees, from -90 through 90. format: double longitude: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$ description: >- Longitude of the geographic coordinate in decimal degrees, from -180 through 180. format: double description: Latitude and longitude coordinate for this lead contact profile. PhoneLocationSource: type: object properties: method: type: string description: >- The resolution method, such as telnyx-city-state, coordinates, phone-number, or state-default. query: type: string description: >- The city, state, coordinates, phone number, or representative ZIP used by the method. nullable: true description: Describes how a phone location value was resolved. ````