--- title: "List activities" method: GET path: "/v1/activities" tags: ["Activities"] --- # List activities `GET /v1/activities` This endpoint returns a list of "activities" for people, similar to your workspace's Activity Logs. This endpoint is guaranteed to return activity history within the past 30 days. It _might_ return data older than 30 days in some circumstances, but activites older than 30 days are not guaranteed. ## Query parameters - `start` string - `type` 'add_relationship' | 'anon_merge' | 'attempted_action' | 'attempted_email' | 'attempted_in_app' | 'attempted_push' | 'attempted_slack' | 'attempted_twilio' | 'attempted_webhook' | 'attempted_whatsapp' | 'attribute_change' | 'bounced_action' | 'bounced_email' | 'bounced_push' | 'bounced_twilio' | 'bounced_whatsapp' | 'clicked_action' | 'clicked_content' | 'clicked_email' | 'clicked_in_app' | 'clicked_push' | 'clicked_twilio' | 'clicked_webhook' | 'converted_action' | 'converted_content' | 'converted_email' | 'converted_in_app' | 'converted_slack' | 'converted_twilio' | 'converted_webhook' | 'converted_whatsapp' | 'deferred_action' | 'deferred_email' | 'deferred_in_app' | 'deferred_push' | 'deferred_slack' | 'deferred_twilio' | 'deferred_webhook' | 'deferred_whatsapp' | 'delete_relationship' | 'delivered_action' | 'delivered_email' | 'delivered_push' | 'delivered_twilio' | 'delivered_whatsapp' | 'device_change' | 'drafted_action' | 'drafted_email' | 'drafted_in_app' | 'drafted_push' | 'drafted_slack' | 'drafted_twilio' | 'drafted_webhook' | 'dropped_action' | 'dropped_email' | 'dropped_push' | 'dropped_twilio' | 'dropped_webhook' | 'dropped_whatasapp' | 'event' | 'failed_action' | 'failed_attribute_change' | 'failed_batch_update' | 'failed_email' | 'failed_event' | 'failed_in_app' | 'failed_object_journeys' | 'failed_push' | 'failed_query_collection' | 'failed_slack' | 'failed_twilio' | 'failed_webhook' | 'failed_whatsapp' | 'opened_action' | 'opened_email' | 'opened_in_app' | 'opened_push' | 'page' | 'profile_create' | 'profile_delete' | 'profile_merge' | 'relationship_attribute_change' | 'relationship_failed_attribute_change' | 'screen' | 'sent_action' | 'sent_email' | 'sent_in_app' | 'sent_push' | 'sent_slack' | 'sent_twilio' | 'sent_webhook' | 'sent_whatsapp' | 'skipped_update' | 'spammed_email' | 'suppressed_twilio' | 'suppressed_whatsapp' | 'topic_unsubscribed_email' | 'undeliverable_action' | 'undeliverable_email' | 'undeliverable_in_app' | 'undeliverable_push' | 'undeliverable_slack' | 'undeliverable_twilio' | 'undeliverable_webhook' | 'undeliverable_whatsapp' | 'unsubscribed_action' | 'unsubscribed_email' | 'viewed_content' | 'webhook_event' | '_o::add_relationship' | '_o::attribute_change' | '_o::create' | '_o::delete' | '_o::delete_relationship' | '_o::failed_attribute_change' | '_r::attribute_change' | '_r::failed_attribute_change' — The type of activity. Types with `_o:` are for objects and types with `_r:` are for relationships. - `name` string - `deleted` boolean - `customer_id` string - `id_type` 'id' | 'email' | 'phone' | 'cio_id' - `limit` integer ## Response `200` Returns an array of `activities`. - object - `activities` ActivityObject[] - `customer_id` string, nullable — The ID of a customer profile, analogous to a "person" in the UI. If your workspace supports multiple identifiers (email and ID), this value can be null. - `customer_identifiers` CustomerIdentifiers — Identifiers for the person in a response—`id`, `cio_id`, and `email`. Unset `id` or `email` values are `null`. We recommend this object over the less descriptive `customer_id`. This object doesn't include `phone`, even if your workspace uses phone numbers as an identifier; look for the person's `phone` attribute instead. - `email` string, email, nullable, required — A person's email address, if set. - `id` string, nullable, required — A person's unique ID, if set. This is the same as the `customer_id` if present. - `cio_id` string, required — A unique identifier set by Customer.io, used to reference a person if you want to update their identifiers. - `data` union - object - `delivered` integer, nullable — The date-time when the message was delivered, if applicable. - `delivery_id` string — The message ID. - `opened` boolean, nullable — Indicates whether or not a customer opened a message, if the message was delivered. - object — The name of the object is the attribute that changed. - `delivery_id` string — The message ID. - `delivery_type` 'ios' | 'android' | 'email' | 'phone' — The recipient device, if applicable. - `id` string — The identifier for the action. - `timestamp` integer — The date and time when the action occurred. - `type` 'add_relationship' | 'anon_merge' | 'attempted_action' | 'attempted_email' | 'attempted_in_app' | 'attempted_push' | 'attempted_slack' | 'attempted_twilio' | 'attempted_webhook' | 'attempted_whatsapp' | 'attribute_change' | 'bounced_action' | 'bounced_email' | 'bounced_push' | 'bounced_twilio' | 'bounced_whatsapp' | 'clicked_action' | 'clicked_content' | 'clicked_email' | 'clicked_in_app' | 'clicked_push' | 'clicked_twilio' | 'clicked_webhook' | 'converted_action' | 'converted_content' | 'converted_email' | 'converted_in_app' | 'converted_slack' | 'converted_twilio' | 'converted_webhook' | 'converted_whatsapp' | 'deferred_action' | 'deferred_email' | 'deferred_in_app' | 'deferred_push' | 'deferred_slack' | 'deferred_twilio' | 'deferred_webhook' | 'deferred_whatsapp' | 'delete_relationship' | 'delivered_action' | 'delivered_email' | 'delivered_push' | 'delivered_twilio' | 'delivered_whatsapp' | 'device_change' | 'drafted_action' | 'drafted_email' | 'drafted_in_app' | 'drafted_push' | 'drafted_slack' | 'drafted_twilio' | 'drafted_webhook' | 'dropped_action' | 'dropped_email' | 'dropped_push' | 'dropped_twilio' | 'dropped_webhook' | 'dropped_whatasapp' | 'event' | 'failed_action' | 'failed_attribute_change' | 'failed_batch_update' | 'failed_email' | 'failed_event' | 'failed_in_app' | 'failed_object_journeys' | 'failed_push' | 'failed_query_collection' | 'failed_slack' | 'failed_twilio' | 'failed_webhook' | 'failed_whatsapp' | 'opened_action' | 'opened_email' | 'opened_in_app' | 'opened_push' | 'page' | 'profile_create' | 'profile_delete' | 'profile_merge' | 'relationship_attribute_change' | 'relationship_failed_attribute_change' | 'screen' | 'sent_action' | 'sent_email' | 'sent_in_app' | 'sent_push' | 'sent_slack' | 'sent_twilio' | 'sent_webhook' | 'sent_whatsapp' | 'skipped_update' | 'spammed_email' | 'suppressed_twilio' | 'suppressed_whatsapp' | 'topic_unsubscribed_email' | 'undeliverable_action' | 'undeliverable_email' | 'undeliverable_in_app' | 'undeliverable_push' | 'undeliverable_slack' | 'undeliverable_twilio' | 'undeliverable_webhook' | 'undeliverable_whatsapp' | 'unsubscribed_action' | 'unsubscribed_email' | 'viewed_content' | 'webhook_event' | '_o::add_relationship' | '_o::attribute_change' | '_o::create' | '_o::delete' | '_o::delete_relationship' | '_o::failed_attribute_change' | '_r::attribute_change' | '_r::failed_attribute_change' — The type of activity. Types with `_o:` are for objects and types with `_r:` are for relationships. - `name` string — The name of the event, for `event` and `screen` activities. - `url` string — The page URL, for `page` activities. - `next` string — Indicates the next page of results. Add `?start=` to the request to get the next page of results. ## Other responses - `429` — Your request is over the 10-per-second limit. --- [API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)