curl -X GET "https://api.tracklysms.com/api/v2/contacts/%2B14155559876" \
  -H "X-Api-Key: trk_your_api_key_here"

import requests
from urllib.parse import quote

phone_number = "+14155559876"
encoded_phone = quote(phone_number, safe="")

response = requests.get(
    f"https://api.tracklysms.com/api/v2/contacts/{encoded_phone}",
    headers={"X-Api-Key": "trk_your_api_key_here"}
)

data = response.json()
print(f"Phone: {data['phone_number']}")
print(f"Carrier: {data['carrier']}")
print(f"Lists: {len(data['lists'])}")

for membership in data["lists"]:
    print(f"  {membership['list_number']} - Active: {membership['active']}")

const phoneNumber = "+14155559876";
const encodedPhone = encodeURIComponent(phoneNumber);

const response = await fetch(
  `https://api.tracklysms.com/api/v2/contacts/${encodedPhone}`,
  {
    method: "GET",
    headers: {
      "X-Api-Key": "trk_your_api_key_here",
    },
  }
);

const data = await response.json();
console.log(`Phone: ${data.phone_number}`);
console.log(`Carrier: ${data.carrier}`);
console.log(`On ${data.lists.length} list(s)`);

{
  "phone_number": "+14155559876",
  "carrier": "T-Mobile",
  "line_type": "mobile",
  "timezone": "America/Los_Angeles",
  "is_valid": true,
  "country": "US",
  "lists": [
    {
      "list_id": 42,
      "list_number": "+18005551234",
      "active": true,
      "signup_date": "2025-03-15T14:30:00",
      "unsub_reason": null,
      "unsub_date": null,
      "custom_fields": {
        "first_name": "Jane",
        "source": "landing_page_v2"
      },
      "send_count": 12,
      "click_count": 3
    },
    {
      "list_id": 43,
      "list_number": "+18005559999",
      "active": false,
      "signup_date": "2025-01-10T09:00:00",
      "unsub_reason": "message",
      "unsub_date": "2025-02-01T11:15:00",
      "custom_fields": {},
      "send_count": 5,
      "click_count": 0
    }
  ]
}

{
  "error": "Invalid E.164 phone number format",
  "code": "invalid_phone"
}

{
  "error": "Contact not found",
  "code": "not_found"
}