> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.brevo.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server.

# User activity logs

## Requirements

Brevo accounts hold account information along with payment plans and client credit details. Prerequisites for using the Accounts endpoints:

1. A valid Brevo account.
2. A valid API key.
3. Some endpoints are limited to Enterprise clients.

\


## 1. Get user activity logs

Send a `GET` request to `https://api.brevo.com/v3/organization/activities`. This endpoint returns information about:

* User login.
* User invitations to access the account.
* Profile edits.
* Invited users accessing the account.
* User email changes.

\


Sample cURL request for `getaccountactivity`:

```curl
curl --request GET \
     --url 'https://api.brevo.com/v3/organization/activities?startDate=2023-01-01&endDate=2023-02-01&limit=10&offset=0' \
     --header 'accept: application/json' \
     --header 'api-key: '
```

\


This endpoint is available to Enterprise clients. Endpoint attributes:

| Attribute   | Datatype | Description                                                                                                                                                                                                                                                                 | Value                                           |
| :---------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------- |
| `startDate` | String   | Mandatory if endDate is used. Enter start date in the (YYYY-MM-DD) format to filter the activity in your account. Maximum time period that can be selected is one month. Additionally, you can retrieve activity logs from the past 12 months from the date of your search. | 2023-01-01                                      |
| `endDate`   | String   | Mandatory if startDate is used. Enter end date in(YYYY-MM-DD) format to filter the activity in your account. Maximum time period that can be selected is one month.                                                                                                         | 2023-02-01                                      |
| `email`     | String   | Enter the user's email address to filter their activity in the account.                                                                                                                                                                                                     | [test@mycompany.com](mailto:test@mycompany.com) |
| `limit`     | Int64    | Number of documents per page                                                                                                                                                                                                                                                | 10                                              |
| `offset`    | Int64    | Index of the first document in the page.                                                                                                                                                                                                                                    | 0                                               |

\


**Response**

Sample JSON response showing login and profile-update activity:

```json
{
  "logs": [
    {
      "action": "login-success",
      "date": "2023-03-16T16:49:23+05:30",
      "user_email": "test@mycompany.com",
      "user_ip": "192.158.1.34",
      "user_agent": "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us)"
    },
    {
      "action": "update-profile",
      "date": "2023-03-15T16:49:23+05:30",
      "user_email": "test@myexample.com",
      "user_ip": "192.158.1.38",
      "user_agent": "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us)",
      "count": 2
    }
  ]
}
```

Response codes:

| Response code | Message                    | Description                                                                                                                                              |
| :------------ | :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200`         | List of user activity logs | Returns the user activity logs.                                                                                                                          |
| `400`         | Bad request                | Returned for errors such as `invalid_parameter`, `permission_denied`, or `not_enough_credits`, including when the account is not on the Enterprise plan. |