# List all activity logs

You can get a log of activities by all admins in an app.

Endpoint: GET /admins/activity_logs
Version: Preview
Security: bearerAuth

## Header parameters:

  - `Intercom-Version` (string)
    Intercom API version.By default, it's equal to the version set in the app package.
    Enum: "1.0", "1.1", "1.2", "1.3", "1.4", "2.0", "2.1", "2.2", "2.3", "2.4", "2.5", "2.6", "2.7", "2.8", "2.9", "2.10", "2.11", "2.12", "2.13", "2.14", "Preview"

## Query parameters:

  - `created_at_after` (string, required)
    The start date that you request data for. It must be formatted as a UNIX timestamp.
    Example: "1677253093"

  - `created_at_before` (string)
    The end date that you request data for. It must be formatted as a UNIX timestamp.
    Example: "1677861493"

  - `event_types` (array)
    An optional list of event types to filter activity logs by. When provided, only logs matching the specified event types are returned. Use the List all activity log event types endpoint to retrieve available values.
    Example: ["admin_login_success","app_name_change"]

## Response 200 fields (application/json):

  - `type` (string)
    String representing the object's type. Always has the value activity_log.list.
    Example: "activity_log.list"

  - `pages` (object,null)
    Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data.
A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.

  - `pages.type` (string)
    the type of object pages.
    Enum: "pages"

  - `pages.page` (integer)
    The current page
    Example: 1

  - `pages.next` (object,null)

  - `pages.next.per_page` (integer)
    The number of results to fetch per page.
    Example: 2

  - `pages.next.starting_after` (string,null)
    The cursor to use in the next request to get the next page of results.
    Example: "your-cursor-from-response"

  - `pages.per_page` (integer)
    Number of results per page
    Example: 2

  - `pages.total_pages` (integer)
    Total number of pages
    Example: 13

  - `activity_logs` (array)
    An array of activity logs

  - `activity_logs.id` (string)
    The id representing the activity.
    Example: "6"

  - `activity_logs.performed_by` (object)
    Details about the Admin involved in the activity.

  - `activity_logs.performed_by.type` (string)
    String representing the object's type. Always has the value admin.
    Example: "admin"

  - `activity_logs.performed_by.id` (string)
    The id representing the admin.
    Example: "1295"

  - `activity_logs.performed_by.email` (string)
    The email of the admin.
    Example: "john@example.com"

  - `activity_logs.performed_by.ip` (string)
    The IP address of the admin.
    Example: "198.51.100.255"

  - `activity_logs.metadata` (object,null)
    Additional data provided about Admin activity.

  - `activity_logs.metadata.sign_in_method` (string,null)
    The way the admin signed in.
    Example: "email_password"

  - `activity_logs.metadata.external_id` (string,null)
    The unique identifier for the contact which is provided by the Client.
    Example: "f3b87a2e09d514c6c2e79b9a"

  - `activity_logs.metadata.away_mode` (boolean,null)
    The away mode status which is set to true when away and false when returned.
    Example: true

  - `activity_logs.metadata.away_status_reason` (string,null)
    The reason the Admin is away.
    Example: "😌 On a break"

  - `activity_logs.metadata.reassign_conversations` (boolean,null)
    Indicates if conversations should be reassigned while an Admin is away.

  - `activity_logs.metadata.source` (string,null)
    The action that initiated the status change.
    Example: "admin update from web - Admin id: 93"

  - `activity_logs.metadata.auto_changed` (string,null)
    Indicates if the status was changed automatically or manually.

  - `activity_logs.metadata.update_by` (integer,null)
    The ID of the Admin who initiated the activity.
    Example: 93

  - `activity_logs.metadata.update_by_name` (string,null)
    The name of the Admin who initiated the activity.
    Example: "Joe Example"

  - `activity_logs.metadata.conversation_assignment_limit` (integer,null)
    The conversation assignment limit value for an admin.
    Example: 15

  - `activity_logs.metadata.ticket_assignment_limit` (integer,null)
    The ticket assignment limit value for an admin.
    Example: 20

  - `activity_logs.created_at` (integer)
    The time the activity was created.
    Example: 1671028894

  - `activity_logs.activity_type` (string)
    Enum: "admin_conversation_assignment_limit_change", "admin_ticket_assignment_limit_change", "admin_away_mode_change", "admin_deletion", "admin_deprovisioned", "admin_impersonation_end", "admin_impersonation_start", "admin_invite_change", "admin_invite_creation", "admin_invite_deletion", "admin_login_failure", "admin_login_success", "admin_logout", "admin_password_reset_request", "admin_password_reset_success", "admin_permission_change", "admin_provisioned", "admin_two_factor_auth_change", "admin_unauthorized_sign_in_method", "app_admin_join", "app_authentication_method_change", "app_data_deletion", "app_data_export", "app_google_sso_domain_change", "app_identity_verification_change", "app_name_change", "app_outbound_address_change", "app_package_installation", "app_package_token_regeneration", "app_package_uninstallation", "app_team_creation", "app_team_deletion", "app_team_membership_modification", "app_timezone_change", "app_webhook_creation", "app_webhook_deletion", "articles_in_messenger_enabled_change", "bulk_delete", "bulk_export", "campaign_deletion", "campaign_state_change", "conversation_part_deletion", "conversation_topic_change", "conversation_topic_creation", "conversation_topic_deletion", "help_center_settings_change", "inbound_conversations_change", "inbox_access_change", "message_deletion", "message_state_change", "messenger_look_and_feel_change", "messenger_search_required_change", "messenger_spaces_change", "office_hours_change", "role_change", "role_creation", "role_deletion", "ruleset_activation_title_preview", "ruleset_creation", "ruleset_deletion", "search_browse_enabled_change", "search_browse_required_change", "seat_change", "seat_revoke", "security_settings_change", "temporary_expectation_change", "upfront_email_collection_change", "welcome_message_change"

  - `activity_logs.activity_description` (string)
    A sentence or two describing the activity.
    Example: "Admin updated the app's name to \"My App\"."

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: "error.list"

  - `request_id` (string,null)
    Example: "f93ecfa8-d08a-4325-8694-89aeb89c8f85"

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code
    Example: "unauthorized"

  - `errors.message` (string,null)
    Optional. Human readable description of the error.
    Example: "Access Token Invalid"

  - `errors.field` (string,null)
    Optional. Used to identify a particular field or query parameter that was in error.
    Example: "email"