---
title: "Retrieve changes for a project."
method: GET
path: "/changes"
tags: ["Change History"]
---

# Retrieve changes for a project.

`GET /changes`

Get a list of changes for a given project using optional filters.

## Query parameters

- `project_id` integer, required
- `id` integer[]
- `start_time` string, date-time
- `end_time` string, date-time
- `user` string[]
- `entity_type` string[]
- `source` string
- `entity` string[]
- `per_page` integer
- `page` integer

## Response `200`

Returns changes.

- ChangeHistoryChange[]
  - `change_type` 'archive' | 'create' | 'update' | 'delete' | 'publish' — Action performed on the entity.
  - `changes` ChangeDetail[] — List of change details.
    - `after` unknown
    - `before` unknown
    - `description` string — Human readable description of the change.
    - `property` string — The name of the property modified.
  - `created` string, date-time — Created time of the current revision. Format is ISO 8601.
  - `entity` Entity
    - `api_url` string, url — Generated URL to access the entity by using the public API.
    - `id` integer — ID of the entity.
    - `name` string — Name of the entity.
    - `sub_type` string — Optional field for entities that have sub_types (projects, experiments, extensions, pages, etc)
    - `type` string — Type of the entity as defined by the public API.
    - `ui_url` string, url — Generated URL to access the entity using Optimizely UI.
  - `id` integer — ID of the change.
  - `project_id` integer, required — ID of the project related to the entity.
  - `revisions` ChangeRevision
    - `current` Revision
      - `id` integer, nullable — Reference to a revision of the entity.
      - `sequence_number` integer, nullable — Auto-generated number assigned to the revision when the entity was modified.
    - `previous` Revision
      - `id` integer, nullable — Reference to a revision of the entity.
      - `sequence_number` integer, nullable — Auto-generated number assigned to the revision when the entity was modified.
  - `source` 'ui' | 'api' — Origin of the current revision.
  - `summary` string — Short human readable description of the change.
  - `user` User
    - `display_name` string, nullable — Display name of the user, most commonly the Optimizely user's email.
    - `email` string, required — Email of the user.
    - `first_name` string, nullable — First name of the user.
    - `id` string, required — ID of the user.
    - `last_name` string, nullable — Last name of the user.
    - `profile_image_url` string, nullable — URL to the user profile image.

---

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