Leadping

Leadping Phone Numbers API

Manages phone-number discovery, purchasing, assignment, configuration, and compliance. Use these endpoints to search available numbers, manage owned numbers and caller identity, configure messaging or voice behavior, and monitor registration and warmup state.

Documentation GitHub OpenAPI

Operations 14

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /phone-numbers/search Search phone numbers to buy · Search purchasable organization phone numbers #

Ask an LLM

“What phone numbers are available to purchase in my area?”

“Can I search for a number to buy by location?”

Tell an agent

Search purchasable numbers near {location}.

Find available numbers matching {phoneNumber}.

POST /phone-numbers/all/organization List my organization's phone numbers · List current-organization phone numbers #

Ask an LLM

“Which phone numbers does my organization own?”

“Can I filter my numbers for messaging and warmup management?”

Tell an agent

List my organization's phone numbers.

Search our owned numbers for {search}.

POST /phone-numbers/outgoing/conversation/{conversationId} Pick the sender number for a conversation · Select conversation sender number #

Ask an LLM

“Which of my numbers will be used to reply in an existing conversation?”

“How is the sending number chosen for an ongoing thread?”

Tell an agent

Select the sender number for conversation {conversationId}.

Choose the reply number for conversation {conversationId} on {channel}.

POST /phone-numbers/outgoing/new Pick the sender number for a new lead · Select new lead sender number #

Ask an LLM

“Which number will be used when I text a new lead for the first time?”

“How does Leadping choose an outgoing number for a brand-new outbound message?”

Tell an agent

Select a sender number for a new outbound to {recipientPhoneNumber}.

Pick an outgoing number for new lead {leadId}.

POST /phone-numbers/outgoing/manual-override Validate a sender number override · Validate sender number override #

Ask an LLM

“Can I check if a number is allowed as a manual sender before using it?”

“Is a particular outgoing-number override eligible for delivery?”

Tell an agent

Validate using number {fromPhoneNumberId} as a manual override for {selection}.

Check if {fromPhoneNumberId} is an eligible manual sender for {selection}.

POST /phone-numbers/outgoing/conversation/{conversationId}/override Pin a sender number to a conversation · Set sender number override #

Ask an LLM

“How do I force a conversation to always use one specific number?”

“Can I override the automatic sender for future messages in a thread?”

Tell an agent

Set conversation {conversationId} to send from {fromPhoneNumberId} for {selection}.

Pin number {fromPhoneNumberId} to conversation {conversationId} using selection {selection}.

DELETE /phone-numbers/outgoing/conversation/{conversationId}/override Clear a conversation's sender override · Clear sender number override #

Ask an LLM

“How do I go back to automatic number selection for a conversation?”

“Can I remove the pinned sender number from a thread?”

Tell an agent destructive · confirm first

Clear the sender override on conversation {conversationId}.

Return conversation {conversationId} to automatic number selection.

GET /phone-numbers/{phoneNumberId} Get a phone number's details · Get organization phone number details by ID #

Ask an LLM

“How do I see the assignment and messaging status of one of my numbers?”

“When was a particular number purchased?”

Tell an agent

Show phone number {phoneNumberId}.

Get details and assignment for number {phoneNumberId}.

PUT /phone-numbers/{phoneNumberId} Update a phone number's settings · Update organization phone number settings #

Ask an LLM

“How do I give one of my phone numbers a friendly label?”

“Can I change the settings of a number I already own?”

Tell an agent

Label phone number {phoneNumberId} as {name}.

Update settings for {phoneNumberId} with number {number}.

DELETE /phone-numbers/{phoneNumberId} Delete a phone number · Delete an organization phone number by ID #

Ask an LLM

“How do I get rid of a number I no longer use for leads?”

“Can I remove a phone number from my organization?”

Tell an agent destructive · confirm first

Delete phone number {phoneNumberId}.

Remove number {phoneNumberId} from my organization.

POST /phone-numbers Buy a phone number · Create an organization phone number for messaging #

Ask an LLM

“How do I buy a new phone number for texting leads?”

“Can I add a number and name it at the same time?”

Tell an agent

Buy phone number {number}.

Purchase {number} and label it {name}.

GET /phone-numbers/{phoneNumber}/status Get a phone number's provider status · Get organization phone number provider status #

Ask an LLM

“Is my number verified with the carrier?”

“What is the provider status of a number over the last few days?”

Tell an agent

Get the provider status of {phoneNumber}.

Show verification status for {phoneNumber} over the last {windowDays} days.

GET /phone-numbers/{phoneNumberId}/warmup Get a phone number's warmup status · Get organization phone number warmup status #

Ask an LLM

“How far along is my new number's warmup?”

“What sending limits apply to a number during warmup?”

Tell an agent

Show warmup status for number {phoneNumberId}.

Get warmup limits for {phoneNumberId} from {startDate} to {endDate}.

POST /phone-numbers/is-available-for-purchase Check if a number can be bought · Check phone number purchase availability #

Ask an LLM

“Is a specific phone number still available to purchase?”

“Can I confirm a number is buyable before I try to add it?”

Tell an agent

Check if {phoneNumber} is available to buy.

Confirm I can purchase number {phoneNumber}.

Leadping Phone Numbers API

Operations 14

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification