activities

List or filter all activity types

Changed on

To list only a specific activity type (e.g., only Call or LeadStatusChange), use the other resources listed separately. When querying activities for a single lead (using the lead_id parameter), you can ask for multiple activity types using _type__in.

When listing Custom Activities, _type and _type__in can include Custom Activity Type ids (e.g. actitype_1h5m6uHM9BZOpwVhyRJb4Y) to filter by a specific custom activity type or Custom to list custom activities of any type.

The following filtering parameters can only be used for listing activities on a single lead (using the lead_id parameter): user_id, user_id__in, contact_id, contact_id__in, _type, _type__in.

All activities have two sortable datetime fields: date_created and activity_at. date_created denotes when an activity was created or synced into Close and activity_at denotes when that activity actually occurred. For example, on outgoing Email activities, date_created is equal to when the email was first created in Close, and activity_at is equal to when the email was actually sent. For Meeting activities, activity_at is equal to the scheduled time of the meeting. On custom activities, users are able to update the activity_at field at any time.

Sorting by -activity_at can only be used when listing activities on a single lead using the lead_id parameter. In addition, you can only use the date-based filters of the field you're currently sorting on. This means that if you want to use activity_at__lt and activity_at__gt as filters, you need to include _order_by=-activity_at in your request.

thread_emails parameter:

  • (Default) when this parameter is not present, Email objects will be returned for each email message.
  • A value of true will return EmailThread objects representing email conversations. Stripped-down version of Email objects will also be returned.
  • A value of only will return EmailThread objects representing email conversations. Email objects will not be returned.
get/activity/

Request

  • Base URL
    https://api.close.com/api/v1
  • URL
    https://api.close.com/api/v1/activity/
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://app.close.com/oauth2/authorize/
      Token URL: https://api.close.com/oauth2/token/

Query parameters

_limitinteger

Number of results to return.

_skipinteger

Number of results to skip before returning, for pagination. The maximum is 35,000 for some organizations.

id__instring[] nullable

Filter by activity IDs (comma-separated)

lead_idstring[] nullable

Filter by lead IDs (comma-separated)

contact_idstring[] nullable

Filter by contact IDs (comma-separated)

user_idstring[] nullable

Filter by user IDs (comma-separated)

organization_idstring nullable
_typestring[] nullable

Filter by activity type, e.g. Call (comma-separated)

string date-time
OR
string date
string date-time
OR
string date
string date-time
OR
string date
string date-time
OR
string date
string date-time
OR
string date
string date-time
OR
string date
string date-time
OR
string date
string date-time
OR
string date
lead_id__instring
user_id__instring
contact_id__instring
_type__instring
_fieldsstring

Comma-separated list of fields to include in the response.

_order_bystring

Response

Successful response

Changes

    • warning

      for the query request parameter _limit, the max was set to 100.00

    • warning

      for the query request parameter _skip, the max was set to 250000.00

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status