API ReferenceTools

Get Contact Card

Retrieve contact information as a vCard and get a presigned URL to download the file.

Headers

PINNACLE-API-KEYstringRequired

Request

This endpoint expects an object.
idintegerRequired>=1
ID of your contact.
optionsobjectOptional

Response

Returns complete contact information.
addresseslist of objects
Physical addresses.
categorieslist of strings
Categories or tags for organizing contacts.
emailslist of objects
Email addresses.
fileobject
File associated to the contact.
formattedNamestring
Full display name for the vCard.
idinteger
Unique identifier for the contact.
nameobject
Structured name components.
phoneslist of objects
Phone numbers.
revisionstring
ISO 8601 timestamp of last vCard update.
birthdaystring or null

Birthday in ISO 8601 date format (YYYY-MM-DD).

geoobject or null
Geographic coordinates.
nicknamelist of strings or null
Nicknames or aliases.
notestring or null
Additional notes or comments.
organizationobject or null
Organization or company information.
rolestring or null
Role or function within the organization.
timezonestring or null

Timezone (e.g., “America/New_York”).

titlestring or null
Job title or position.
urlstring or null
Website URL.

Errors