Skip to main content
The CallHeater API accepts phone lookup requests and returns caller context as JSON or plain text.

Base URL

https://api.callheater.com

Authentication

Send your provided API key in the X-API-Key header.
curl "https://api.callheater.com/lookup?phone=4155550123" \
  -H "X-API-Key: YOUR_API_KEY"

Endpoints

Lookup a phone number

Return caller context for a phone number.

Check API health

Confirm the API is online.

Check API key credits

Verify an API key and view its credit balance.