Getting Started
- Introduction
- Webhooks
Text
Identity
- Verification Sessions
- Verification Reports
Enterprise
- Overview
- Text
- iMessage
- WhatsApp
- Message Intents
- Lease
- Email
- Identity
Use Specific Number
Get a list of numbers available for adoption
curl --request GET \
--url https://api.contiguity.co/enterprise/lease/purchasable \
--header 'Authorization: Bearer <token>'
{
"id": "psr_abc123",
"object": "pool_available_adoption",
"created_at": 123,
"data": {
"text": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
],
"imessage": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
],
"whatsapp": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
],
"voice": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
]
}
}
This endpoint requires an Enterprise plan.
Authorizations
Authentication using a Bearer Token. Specify Authorization: Token YOUR_TOKEN
. Bearer
is allowed.
Query Parameters
Filter by supported features
sms
, mms
, whatsapp
, imessage
, audio
Filter by number type
text
, whatsapp
, imessage
Filter by country code
US
, CA
, UK
, FR
Filter by carrier
TMO
, ATT
, CONTIGUITY
Response
Unique identifier for the response
pool_available_adoption
Unix timestamp of when the response was created
Type of number
text
, whatsapp
, imessage
Phone number
Country code
Supported features
sms
, mms
, whatsapp
, imessage
, audio
Carrier code
Type of number
text
, whatsapp
, imessage
Phone number
Country code
Supported features
sms
, mms
, whatsapp
, imessage
, audio
Carrier code
Current status of the number
available
Health status of the number
good
, unknown
Formatted phone number
E.164 formatted phone number
Type of number
text
, whatsapp
, imessage
Phone number
Country code
Supported features
sms
, mms
, whatsapp
, imessage
, audio
Carrier code
Current status of the number
available
Health status of the number
good
, unknown
Formatted phone number
E.164 formatted phone number
Type of number
text
, whatsapp
, imessage
Phone number
Country code
Supported features
sms
, mms
, whatsapp
, imessage
, audio
Carrier code
Was this page helpful?
curl --request GET \
--url https://api.contiguity.co/enterprise/lease/purchasable \
--header 'Authorization: Bearer <token>'
{
"id": "psr_abc123",
"object": "pool_available_adoption",
"created_at": 123,
"data": {
"text": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
],
"imessage": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
],
"whatsapp": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
],
"voice": [
{
"type": "text",
"number": "14155552671",
"country": "US",
"supports": [
"sms"
],
"carrier": "TMO",
"data": {
"status": "available",
"health": "good",
"formatted": "+1 (415) 555-2671",
"e164": "+14155552671"
}
}
]
}
}