# Get the changelog of a dynamic set.

`GET /sets/{set_id}/changelog`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-set-changelog · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetSetChangelog` · Tag: Dynamic Sets

Returns the history of changes made to the set (membership changes, edits), ordered oldest first and optionally restricted to a date range. **Paid sets only.** Returns `404 Not Found` for a free set — upgrade it first with `POST /sets/{set_id}/upgrade`.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/sets/{set_id}/changelog`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `set_id` | integer | yes | The Wheelhouse internal dynamic set ID. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `after` | string (date) | no | Only include changes on or after this date (YYYY-MM-DD). |
| `before` | string (date) | no | Only include changes before this date (YYYY-MM-DD, exclusive). |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/sets/{set_id}/changelog' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Array of changelog entries.

Body (`application/json`): array of object `set_changelog_entry_response`

A change made to a dynamic set.

- `action` (string): The action that was performed (e.g. listing added/removed, set edited).
- `edit_details` (object, nullable): Details about the change.
- `listing_id` (integer, nullable): The Wheelhouse internal ID of the affected member listing, if the change concerns a listing.
- `created_at` (string (date-time)): When the change happened (ISO-8601).

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "action": "string",
    "edit_details": {},
    "listing_id": 0,
    "created_at": "2026-01-01T00:00:00Z"
  }
]
```

### 401

API key authorization failed.

### 404

Dynamic set not found, not accessible to the user, or not a paid set.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
