Skip to main content
Call history requires a contact ID. Do not put a phone number directly in /v1/contacts/{contactId}/call-history.

1. Find the contact

Use Get contact by identifier with identifierType=phone_number and the URL-encoded international phone number. Read the returned contact ID.

2. Retrieve history

Use that ID with Get contact call history:
If no contact matches, check the organization and number format before creating or changing records. For date, status, or other call filters, use List calls with its documented query parameters.