# list_changes

> Lists the change markers recorded for a site, newest deploy date first, optionally only for one exact page or ticket reference. Use it to find markers before…

**Source:** [https://queryhippo.com/docs/tools/list_changes](https://queryhippo.com/docs/tools/list_changes)

Which changes have we recorded for this site, and which are ready to measure?

- Read-only
- No external calls

## When to use it

Lists the change markers recorded for a site, newest deploy date first, optionally only for one exact page or ticket reference. Use it to find markers before measuring them, or to check what has already been recorded.

## Ask your AI

- Which changes have we recorded on this site, and which are ready to measure?
- Show the change markers for ticket HUM-52.
- List every change recorded for /compare/svelte-virtuallists, including removed ones.

## Parameters

| Name | Type | Details | What it means |
| --- | --- | --- | --- |
| `propertyId` (required) | `string` | 1–200 characters; pattern ^[a-zA-Z0-9._:-]+$ | The ID of the site to read, as returned by list_sites. You must own the site or have been granted access to it. |
| `page` | `string` | 1–4096 characters | Optional exact page URL; only markers for that page are returned, and only suggestions for the same sitemap URL. |
| `external_ref` | `string` | 1–500 characters | Optional exact ticket or pull request reference; only markers with that reference are returned, and no suggestions. |
| `include_removed` | `boolean` | default false | Also return removed markers. Defaults to false. |
| `include_suggestions` | `boolean` | default true | Also suggest unrecorded changes from sitemap lastmod changes in the last 90 days. Defaults to true; set false to return markers only. |
| `limit` | `integer` | default 50; minimum 1; maximum 100 | How many markers to return, from 1 to 100. Defaults to 50. |

## What it returns

The latest complete day of data (data_through), the window rule used (28 days before and after the deploy day, which is left out), the total number of matching markers and how many were returned, and the markers themselves. Each marker has the same fields record_change returns, including outcome_ready_on and outcome_ready. It also returns suggestions: up to 20 unrecorded changes inferred from sitemap lastmod changes seen in the last 90 days, newest first. Each gives the sitemap page URL, a suggested deploy date, its basis (sitemap_lastmod when the lastmod date was usable, otherwise sitemap_snapshot_day, meaning the change happened on or before that snapshot day), the day the change was seen, and the new and previous lastmod values. suggestions_truncated is true when more existed.

## Notes

- Anyone who can read the site can list its markers. The page and ticket filters match exactly.
- Suggestions are never recorded automatically; confirm one with record_change. A lastmod change says something changed, not what, and some sites update lastmod on every build. A suggestion is left out when an active marker for the same page has a deploy date within 7 days of it, and none are returned when filtering by ticket reference.
- A suggested page is the sitemap URL. It may differ from how Search Console reports the page, for example with or without a trailing slash, so check it with compare_page_performance before recording.
- Read-only: it reads data QueryHippo has already stored. It does not start a collection, fetch anything or call an AI model.

## Description your AI sees

> List recorded change markers for a property, newest deploy first, optionally by exact page or ticket reference, with the date the default 28-day after-window completes and whether data has reached it. No external calls. Also suggests unrecorded changes from sitemap lastmod changes in the last 90 days; suggestions are never recorded automatically.

## Full schemas

**Input schema**

```
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "propertyId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[a-zA-Z0-9._:-]+$"
    },
    "page": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "external_ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "include_removed": {
      "default": false,
      "type": "boolean"
    },
    "include_suggestions": {
      "default": true,
      "type": "boolean"
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "propertyId"
  ],
  "additionalProperties": false
}
```