---
title: "List all activity logs"
method: GET
path: "/activity_logs"
tags: ["activity_logs"]
---

# List all activity logs

`GET /activity_logs`

This endpoint retrieves all existing activity logs that represent actions performed on application resources.

## Query parameters

- `page` integer
- `per_page` integer
- `from_date` string, date
- `to_date` string, date
- `activity_types[]` string[]
- `activity_sources[]` string[]
- `user_emails[]` string[]
- `external_customer_id` string
- `external_subscription_id` string
- `resource_ids[]` string[]
- `resource_types[]` string[]

## Response `200`

List of activity logs

- ActivityLogsPaginated
  - `activity_logs` ActivityLogObject[], required
    - `activity_id` string, uuid, required — Unique identifier assigned to the activity log within the Lago application. This ID is exclusively created by Lago and serves as a unique identifier for the activity log record within the Lago system
    - `user_email` string, email, nullable — The email of the user who performed the activity
    - `activity_type` string, required — This field stores the actitivy action that was performed to the activity_object.
    - `activity_source` 'api' | 'front' | 'system', required — This field represents the source of the activity log, the interaction source that triggered the action.
    - `activity_object` object, nullable — This field represents the final state of the object that the action was applied.
    - `activity_object_changes` object, nullable
    - `external_customer_id` string, nullable — The customer external unique identifier (provided by your own application)
    - `external_subscription_id` string, nullable — Unique identifier assigned to the subscription in your application.
    - `resource_id` string, uuid, required — The resource id of the object that the action was applied.
    - `resource_type` string, required — The resource type of the resource_id record.
    - `organization_id` string, uuid, required — Unique identifier for the organization associated with the activity log.
    - `logged_at` string, date-time, required — The logged date of the activity, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application
    - `created_at` string, date-time, required — The creation date of the activity record in the Lago application, presented in the ISO 8601 datetime format, specifically in Coordinated Universal Time (UTC). It provides the precise timestamp of when the event's record was created within the Lago application
  - `meta` PaginationMeta, required
    - `current_page` integer, required — Current page.
    - `next_page` integer, nullable — Next page.
    - `prev_page` integer, nullable — Previous page.
    - `total_pages` integer, required — Total number of pages.
    - `total_count` integer, required — Total number of records.

## Other responses

- `401` — Unauthorized error

---

[API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) · [All operations](https://skmtc.dev/getlago/apis/lago-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getlago/lago-api-documentation/revisions/6e969ef3bb45/schema)
