Get Contacts

Retrieve contact information for a given number.

Headers

PINNACLE-API-KEYstringRequired

Query parameters

idintegerOptional>=1

Unique identifier of a specific contact you want to retrieve.

Either this parameter or phoneNumber must be provided, but not both.

phoneNumberstringOptionalformat: "^%2B[1-9]\d{1,14}$"

Phone number you want to look up contact information for, provided in URL-encoded E.164 format with %2B prefix instead of +.

Response

Successfully retrieved.
idinteger
Unique ID of the contact.
phoneNumberstring
Contact's phone number in E.164 format.
descriptionstring or null
Additional information about the contact.
emailstring or null
Contact's email address, if available.
namestring or null
Full name of the contact, if available.
tagslist of strings or null
List of tags associated with the contact.

Errors