List contacts
Contacts
List contacts
List current user contacts
GET
List contacts
Authorizations
Use the Authorization header with Bearer scheme.
Examples:
- API Key: Authorization: Bearer calid_xxxxx
Query Parameters
Search by name, email, phone, or notes.
Example:
"jane"
Field used for sorting contacts.
Available options:
name, email, createdAt, updatedAt Example:
"name"
Sort direction.
Available options:
asc, desc Example:
"asc"
Comparison operator for createdAtValue.
Available options:
gt, lt Example:
"gt"
ISO datetime used with createdAtOperator.
Example:
"2026-05-01T00:00:00.000Z"
Comparison operator for lastMeetingValue.
Available options:
gt, lt Example:
"lt"
ISO datetime used with lastMeetingOperator.
Example:
"2026-05-01T00:00:00.000Z"
Maximum number of contacts returned.
Required range:
1 <= x <= 100Example:
10
Zero-based row offset.
Required range:
x >= 0Example:
0
Related topics
Work with contactsList a contact's meetingsManaging Your Contacts in Cal IDDelete a contactGet a contact