GET
/
leased
cURL
curl --request GET \
  --url https://api.contiguity.com/numbers/leased \
  --header 'Authorization: Bearer <token>'
{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1755722229870,
  "api_version": "v2025.8.20",
  "object": "response",
  "data": {
    "leased": 1,
    "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
        },
        "lease_id": "lsd_1234567890",
        "lease_status": "active",
        "billing": {
          "method": "monthly",
          "period": {
            "start": 1718851200,
            "end": null
          }
        }
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200
application/json

Get all phone numbers currently leased by the user

The response is of type object.