cURL
curl --request GET \
--url https://api.contiguity.com/numbers/leases \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.contiguity.com/numbers/leases"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.contiguity.com/numbers/leases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.contiguity.com/numbers/leases",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.contiguity.com/numbers/leases"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.contiguity.com/numbers/leases")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.contiguity.com/numbers/leases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "req_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "response",
"data": {
"available": 10,
"numbers": [
{
"id": "+13059478667",
"status": "available",
"number": {
"e164": "+13059478667",
"formatted": "+1 (305) 947-8667"
},
"location": {
"country": "US",
"region": "FL",
"city": "Miami"
},
"carrier": "T-Mobile",
"capabilities": {
"intl_sms": true,
"channels": [
"sms",
"mms",
"imessage"
]
},
"health": {
"reputation": 0.9,
"previous_owners": 1
},
"data": {
"requirements": [
"imessage_entitlement_required"
],
"e911_capable": true
},
"created_at": 1718851200,
"pricing": {
"currency": "USD",
"upfront_fee": 2.99,
"monthly_rate": 19.99
}
}
]
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Bad Request",
"status": 400
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Unauthorized",
"status": 401
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Forbidden",
"status": 403
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Internal Server Error",
"status": 500
}
}Lease
Available Leases
Get all numbers available for lease
GET
/
leases
cURL
curl --request GET \
--url https://api.contiguity.com/numbers/leases \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.contiguity.com/numbers/leases"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.contiguity.com/numbers/leases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.contiguity.com/numbers/leases",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.contiguity.com/numbers/leases"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.contiguity.com/numbers/leases")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.contiguity.com/numbers/leases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "req_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "response",
"data": {
"available": 10,
"numbers": [
{
"id": "+13059478667",
"status": "available",
"number": {
"e164": "+13059478667",
"formatted": "+1 (305) 947-8667"
},
"location": {
"country": "US",
"region": "FL",
"city": "Miami"
},
"carrier": "T-Mobile",
"capabilities": {
"intl_sms": true,
"channels": [
"sms",
"mms",
"imessage"
]
},
"health": {
"reputation": 0.9,
"previous_owners": 1
},
"data": {
"requirements": [
"imessage_entitlement_required"
],
"e911_capable": true
},
"created_at": 1718851200,
"pricing": {
"currency": "USD",
"upfront_fee": 2.99,
"monthly_rate": 19.99
}
}
]
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Bad Request",
"status": 400
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Unauthorized",
"status": 401
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Forbidden",
"status": 403
}
}{
"id": "err_xxxxxxxxxxxxxxxx",
"timestamp": 1787071017019,
"api_version": "v2026.8.18",
"object": "error",
"data": {
"error": "Internal Server Error",
"status": 500
}
}Searching by criteria (e.g. carrier, location, etc.) is not supported yet, but is planned.
Contiguity only returns the leases you may be eligible for, rather than showing all available leases. If you need access to a broader selection of leases than what’s currently visible to you, please reach out to us via email or Discord.

Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Was this page helpful?