---
title: "Get activity logs"
method: GET
path: "/v1/activity_logs"
tags: ["Activity Logs"]
---

# Get activity logs

`GET /v1/activity_logs`

Returns a list of activity log events

## Query parameters

- `events` string
- `start_time` number
- `end_time` number
- `limit` number
- `order` 'asc' | 'desc'

## Response `200`

Response from the GET /v1/activity_logs endpoint.

- object
  - `status` 200 — The response status code.
  - `error` false — For successful requests, this value is always `false`.
  - `meta` object
    - `activity_logs` ActivityLog[] — An array of activity logs sorted by timestamp in ascending order by default.
      - `id` string, required — The ID of the event.
      - `timestamp` number, required — The timestamp of the event in seconds since the Unix epoch.
      - `actor` object, nullable, required — The user who performed the action.
        - `type` 'user' — The type of the user.
        - `id` string — The ID of the user.
        - `name` string, required — The name of the user. For SCIM events, the value is "SCIM Provider". For official support actions, the value is "Figma Support".
        - `email` string — The email of the user.
      - `action` object, required — The task or activity the actor performed.
        - `type` string, required — The type of the action.
        - `details` object, nullable, required — Metadata of the action. Each action type supports its own metadata attributes.
      - `entity` union, required — The resource the actor took the action on. It can be a user, file, project or other resource types.
        - ActivityLogUserEntity — A Figma user
          - `type` 'user', required — The type of entity.
          - `id` string, required — Unique stable id of the user.
          - `name` string, required — Name of the user.
          - `email` string, required — Email associated with the user's account.
        - ActivityLogFileEntity — A Figma Design or FigJam file
          - `type` 'file', required — The type of entity.
          - `key` string, required — Unique identifier of the file.
          - `name` string, required — Name of the file.
          - `editor_type` 'figma' | 'figjam', required — Indicates if the object is a file on Figma Design or FigJam.
          - `link_access` 'view' | 'edit' | 'org_view' | 'org_edit' | 'inherit', required — Access policy for users who have the link to the resource.
          - `proto_link_access` 'view' | 'org_view' | 'inherit', required — Access policy for users who have the link to the file's prototype.
        - ActivityLogFileRepoEntity — A file branch that diverges from and can be merged back into the main file
          - `type` 'file_repo', required — The type of entity.
          - `id` string, required — Unique identifier of the file branch.
          - `name` string, required — Name of the file.
          - `main_file_key` string, required — Key of the main file.
        - ActivityLogProjectEntity — A project that a collection of Figma files are grouped under
          - `type` 'project', required — The type of entity.
          - `id` string, required — Unique identifier of the project.
          - `name` string, required — Name of the project.
        - ActivityLogTeamEntity — A Figma team that contains multiple users and projects
          - `type` 'team', required — The type of entity.
          - `id` string, required — Unique identifier of the team.
          - `name` string, required — Name of the team.
        - ActivityLogWorkspaceEntity — Part of the organizational hierarchy of managing files and users within Figma, only available on the Enterprise Plan
          - `type` 'workspace', required — The type of entity.
          - `id` string, required — Unique identifier of the workspace.
          - `name` string, required — Name of the workspace.
        - ActivityLogOrgEntity — A Figma organization
          - `type` 'org', required — The type of entity.
          - `id` string, required — Unique identifier of the organization.
          - `name` string, required — Name of the organization.
        - ActivityLogPluginEntity — A Figma plugin
          - `type` 'plugin', required — The type of entity.
          - `id` string, required — Unique identifier of the plugin.
          - `name` string, required — Name of the plugin.
          - `editor_type` 'figma' | 'figjam', required — Indicates if the object is a plugin is available on Figma Design or FigJam.
        - ActivityLogWidgetEntity — A Figma widget
          - `type` 'widget', required — The type of entity.
          - `id` string, required — Unique identifier of the widget.
          - `name` string, required — Name of the widget.
          - `editor_type` 'figma' | 'figjam', required — Indicates if the object is a widget available on Figma Design or FigJam.
      - `context` object, required — Contextual information about the event.
        - `client_name` string, nullable, required — The third-party application that triggered the event, if applicable.
        - `ip_address` string, required — The IP address from of the client that sent the event request.
        - `is_figma_support_team_action` boolean, required — If Figma's Support team triggered the event. This is either true or false.
        - `org_id` string, required — The id of the organization where the event took place.
        - `team_id` string, nullable, required — The id of the team where the event took place -- if this took place in a specific team.
    - `cursor` string — Encodes the last event (the most recent event)
    - `next_page` boolean — Whether there is a next page of events

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `401` — Token is missing or incorrect.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

## Changes

> 36 revisions in range; 33 could not be searched.

- **2023-12-14** `de5c0106668d` — 4 info
  - the endpoint scheme security `PlanAccessToken` was removed from the API
  - the response property `meta/activity_logs/items/actor/email` became required for the status `200`
  - the response property `meta/activity_logs/items/actor/id` became required for the status `200`
  - the response property `meta/activity_logs/items/actor/type` became required for the status `200`

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v1/activity_logs/get.md)

---

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