Get All Contacts
Returns a paginated list of CRM contacts across all events in your account. Unlike registrants, contacts are not event-specific and can be linked to registrations across multiple events. Default fields returned are id, first_name, and last_name — use fields to request additional properties. Use expand with homeAddress, workAddress, or billingAddress to include address objects. Use search to filter by any contact field and sort to control ordering.
Authorizations
OAuth 2.0 bearer token obtained from POST /oauth2/token. Tokens expire after 30 minutes. Include in the Authorization header as Bearer {access_token}.
Query Parameters
string - optional - Comma separated list of fields you want to return
"account_id,bio,birth_date,cc_email,company,created_at,email,first_name,gender,id,job_title,last_name,middle_name,mobile_phone,notes,prefix,profile_picture,subscribe_status,suffix,twitter_handle,updated_at,vat_number,work_phone"
string - optional - Comma separated list of objects you want to return
"homeAddress,workAddress,billingAddress"
string - optional - Filter conditions to narrow the results. Valid operators are =, !=, >=, <=, >, <, contains, beginswith, endswith
"id>123"
integer - optional - The page of results you want to view
"1"
integer - optional - The number of results per page (to a max of 200)
"5"
string - optional - Sort the results (add - in front for opposite sort direction, e.g. "-id")
Comma-separated list of IDs to retrieve. When provided, only records matching these IDs are returned. All values must be positive integers. Maximum 100 IDs per request.
Body
The body is of type object.