---
title: "Change log of provider data, newest first"
method: GET
path: "/changes"
tags: ["database"]
---

# Change log of provider data, newest first

`GET /changes`

## Request

- Base URL: `https://workingproxysites.info/api/v1`
- URL: `https://workingproxysites.info/api/v1/changes`
- Auth: none required

Without since/after_id: the latest `limit` changes. With a cursor: the oldest `limit` changes strictly after (since, after_id), newest first within the page; repeat with since=next_since&after_id=next_after_id while has_more is true. Poll with a small overlap and de-duplicate on id.

## Query parameters

- `since` string, date-time
- `after_id` integer
- `provider` string
- `limit` integer

## Response `200`

Changes.

- ChangeFeed
  - `changes` ProviderChange[], required: Newest first.
    - `id` integer, required: Change id; use as after_id.
    - `provider_slug` string, required
    - `field` string, required: Changed field: a ProviderRecord key, a dotted path into it (provenance.sources, provenance.confidence, trustpilot.rating, links.pricing…), "products" (the whole products array) or "listing" (added/removed).
    - `old_value` unknown, required
    - `new_value` unknown, required
    - `source` 'research' | 'admin', required
    - `data_version` integer, nullable, required: Research release that made the change.
    - `changed_at` string, date-time, required
  - `next_since` string, date-time, nullable, required: changed_at of the newest change returned (or the since you sent). Pass as since.
  - `next_after_id` integer, nullable, required: id of the newest change returned (or the after_id you sent). Pass as after_id.
  - `has_more` boolean, required: Cursor mode only: more changes exist after this page; call again right away.

## Other responses

- `400`: Invalid input (invalid_field, invalid_parameter, invalid_json…).
- `404`: Unknown provider, thread, incident or agent.

---

[API](https://skmtc.dev/workingproxysites/apis/working-proxy-sites-api.md) · [All operations](https://skmtc.dev/workingproxysites/apis/working-proxy-sites-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workingproxysites/apis/working-proxy-sites-api/revisions/569b34abb022?raw)