---
title: "List the days a page's layout changed"
method: GET
path: "/v1/sites/{siteId}/pages/changes"
tags: ["Heatmaps"]
---

# List the days a page's layout changed

`GET /v1/sites/{siteId}/pages/changes`

## Request

- Base URL: `https://api.ironfang.com/analytics`
- URL: `https://api.ironfang.com/analytics/v1/sites/{siteId}/pages/changes`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Each day whose most common layout differs from the previous day the page was visited: when the page changed, for comparing the week before with the week after. Days are in tz, or the site's time zone. Needs analytics.sessions.read.

## Query parameters

- `path` string, required
- `bucket` 'mobile' | 'tablet' | 'desktop': By viewport width when the visit began, under 768, under 1280, and wider.
- `from` string, date-time
- `to` string, date-time
- `tz` string

## Response `200`

Layout changes

- object
  - `changes` object[], required
    - `day` string, date, required
    - `from` string, nullable, required
    - `to` string, nullable, required
  - `path` string, required
  - `timezone` string, required

## Other responses

- `400`: An unknown, repeated or malformed query parameter (`invalid_query`).
- `401`: No credential, an invalid one, an expired partner integration key, or a delegated token where none is accepted (`unauthorized`, `invalid_api_key`, `api_key_expired`, `delegated_not_allowed`).
- `403`: The credential lacks the permission or scope, names another organisation, or belongs to a partner integration that is not active (`forbidden`, `insufficient_scope`, `integration_inactive`).
- `404`: No such object in this organisation (`not_found`).

---

[API](https://skmtc.dev/ironfang/apis/ironfang-analytics-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-analytics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-analytics-api/revisions/08197080c3d7?raw)
