# List Activity Logs

List activity logs of an account.

## Parameters

- `action_groups` (array of enums, optional)
  Filter results to only include activity logs for the specified action group types.
Possible enum values:
  - `api_key`
    An API key related action group.

  - `user_invite`
    A user invite related action group.

  - `user_roles`
    User roles related action group.

- `actions` (array of enums, optional)
  Filter results to only include activity logs for the specified action types.
Possible enum values:
  - `api_key_created`
    An API key was created.

  - `api_key_deleted`
    An API key was deleted.

  - `api_key_updated`
    An API key was updated.

  - `api_key_viewed`
    An API key’s secret was viewed.

  - `user_invite_accepted`
    A user invite was accepted.

  - `user_invite_created`
    A user invite was created.

  - `user_invite_deleted`
    A user invite was deleted.

  - `user_roles_deleted`
    A user’s roles were deleted.

  - `user_roles_updated`
    A user’s roles were updated.

- `limit` (integer, optional)
  Maximum number of results to return per page.

- `page` (string, optional)
  Pagination token from a previous request. Used to retrieve the next page of results.

## Returns

## Response attributes

- `data` (array of objects)
  List of activity logs.

  - `data.id` (string)
    Unique identifier of the activity log entry.

  - `data.object` (string, value is "v2.iam.activity_log")
    String representing the object’s type. Objects of the same type share the same value of the object field.

  - `data.actor` (object)
    The actor that performed the action.

    - `data.actor.api_key` (object, nullable)
      Set when the actor is an API key.

      - `data.actor.api_key.id` (string)
        Unique identifier of the API key.

    - `data.actor.type` (enum)
      The type of actor.
Possible enum values:
      - `api_key`
        An API key actor.

      - `user`
        A user actor.

    - `data.actor.user` (object, nullable)
      Set when the actor is a user.

      - `data.actor.user.email` (string)
        Email address of the user.

  - `data.context` (string)
    The account on which the action was performed.

  - `data.created` (timestamp)
    Timestamp when the activity log entry was created.

  - `data.details` (object)
    Action-specific details of the activity log entry.

    - `data.details.api_key` (object, nullable)
      Details of an API key action.

      - `data.details.api_key.id` (string)
        Unique identifier of the API key.

      - `data.details.api_key.created` (timestamp)
        Timestamp when the API key was created.

      - `data.details.api_key.expires_at` (timestamp, nullable)
        Timestamp when the API key expires.

      - `data.details.api_key.ip_allowlist` (array of strings)
        List of IP addresses allowed to use this API key.

      - `data.details.api_key.managed_by` (object, nullable)
        Information about the entity managing this API key.

        - `data.details.api_key.managed_by.application` (object, nullable)
          An application.

          - `data.details.api_key.managed_by.application.id` (string)
            Identifier of the application.

        - `data.details.api_key.managed_by.type` (enum)
          The type of entity.
Possible enum values:
          - `application`
            Application.

      - `data.details.api_key.name` (string, nullable)
        Name of the API key.

      - `data.details.api_key.new_key` (string, nullable)
        Unique identifier of the new API key, set when this key was rotated.

      - `data.details.api_key.note` (string, nullable)
        Note or description for the API key.

      - `data.details.api_key.type` (enum)
        Type of the API key.
Possible enum values:
        - `publishable_key`
          A publishable API key.

        - `secret_key`
          A secret API key.

    - `data.details.type` (enum)
      The action group type of the activity log entry.
Possible enum values:
      - `api_key`
        An API key related action group.

      - `user_invite`
        A user invite related action group.

      - `user_roles`
        User roles related action group.

    - `data.details.user_invite` (object, nullable)
      Details of a user invite action.

      - `data.details.user_invite.invited_user_email` (string)
        Email address of the invited user.

      - `data.details.user_invite.roles` (array of strings)
        Roles assigned to the invited user.

    - `data.details.user_roles` (object, nullable)
      Details of a user role change action.

      - `data.details.user_roles.new_roles` (array of strings)
        Roles the user has after the change.

      - `data.details.user_roles.old_roles` (array of strings)
        Roles the user had before the change.

      - `data.details.user_roles.user_email` (string)
        Email address of the user whose roles were changed.

  - `data.livemode` (boolean)
    Whether the action was performed in live mode.

  - `data.type` (enum)
    The type of action that was performed.
Possible enum values:
    - `api_key_created`
      An API key was created.

    - `api_key_deleted`
      An API key was deleted.

    - `api_key_updated`
      An API key was updated.

    - `api_key_viewed`
      An API key’s secret was viewed.

    - `user_invite_accepted`
      A user invite was accepted.

    - `user_invite_created`
      A user invite was created.

    - `user_invite_deleted`
      A user invite was deleted.

    - `user_roles_deleted`
      A user’s roles were deleted.

    - `user_roles_updated`
      A user’s roles were updated.

- `next_page_url` (string, nullable)
  URL to fetch the next page of the list. If there are no more pages, the value is null.

- `previous_page_url` (string, nullable)
  URL to fetch the previous page of the list. If there are no previous pages, the value is null.

## Error Codes

| HTTP status code | Code            | Description                                                       |
| ---------------- | --------------- | ----------------------------------------------------------------- |
| 400              | invalid_filters | Error returned when filter parameters in the request are invalid. |

```curl
curl https://api.stripe.com/v2/iam/activity_logs \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-04-22.preview" \
  -H "Stripe-Context: {{CONTEXT}}"
```

### Response

```json
{
  "data": [
    {
      "id": "accact_1SdeybAiQNL8swvtMHyVtfCU",
      "object": "v2.iam.activity_log",
      "created": "2025-01-02T00:00:00.000Z",
      "type": "api_key_created",
      "livemode": true,
      "context": "acct_1SdeybAiQNL8swvt",
      "actor": {
        "type": "user",
        "user": {
          "email": "user@example.com"
        }
      },
      "details": {
        "type": "api_key",
        "api_key": {
          "id": "mk_1SdeybAiQNL8swvtMHyVtfCU",
          "created": "2025-01-02T00:00:00.000Z",
          "type": "secret_key",
          "name": "My API Key",
          "note": "",
          "expires_at": null,
          "ip_allowlist": [],
          "new_key": null,
          "managed_by": null
        }
      }
    },
    {
      "id": "accact_1Sdet2AiQNL8swvt4Ui4NzaX",
      "object": "v2.iam.activity_log",
      "created": "2025-01-01T00:00:00.000Z",
      "type": "user_invite_created",
      "livemode": true,
      "context": "acct_1SdeybAiQNL8swvt",
      "actor": {
        "type": "user",
        "user": {
          "email": "admin@example.com"
        }
      },
      "details": {
        "type": "user_invite",
        "user_invite": {
          "invited_user_email": "newuser@example.com",
          "roles": [
            "developer"
          ]
        }
      }
    }
  ],
  "next_page_url": "/v2/iam/activity_logs?page=page_0NQAjX2r1Ck82gY4Pd601CN96ge7SJEEICEzTGRS5KR3xV0lf9ds4Xb2Wa1NK6J3IA7Gnu8of5JWHYFEJ1BB1qO8bk8hU88E3bs7u",
  "previous_page_url": null
}
```