# Get times of latest changes for a listing.

`GET /listings/{listing_id}/recent_changes`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-listing-recent-changes · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetListingRecentChanges` · Tag: Listings

Returns when the listing's preferences and custom rates last changed. Compare the timestamps with the ones from your previous call, and re-read `GET /preferences/{listing_id}` or `GET /listings/{listing_id}/custom_rates` only when they moved. See [Keeping a local copy fresh](https://docs.usewheelhouse.com/rm/usage.md#keeping-a-local-copy-fresh).

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/recent_changes`

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 |
| --- | --- | --- | --- |
| `listing_id` | string | yes | The channel's unique listing identifier, or the Wheelhouse listing ID when `channel` is `wheelhouse`. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | string | yes | Channel name the listing is on (the `channel` field of the [/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md) response), or the literal `wheelhouse` to read `listing_id` as a Wheelhouse listing ID instead. See [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md). |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/recent_changes?channel=<channel>' \
  -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

Recent change timestamps in UTC.

Body (`application/json`): object

- `settings` (string (date-time)): When the listing's preferences were last updated (ISO-8601). In this response, 'settings' refers to listing preferences — what the Wheelhouse app calls 'Settings'.
- `rates` (string (date-time), nullable): When a custom rate on the listing was last added, changed, split or removed (ISO-8601). A rate expiring, or its dates passing, does not change it. `null` when no custom rate is on record for the listing (old rate history is deleted after a while, so `null` does not prove the listing never had one).

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

```json
{
  "settings": "2026-01-01T00:00:00Z",
  "rates": "2026-01-01T00:00:00Z"
}
```

### 401

API key authorization failed.

### 403

Listing authorization failed.

### 404

Listing not found.

### 406

The listing is inactive. See the **Inactive Listings** section in the overview.

Body (`application/json`): object

- `error` (string, example: `Listing '12345' is inactive`)

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

```json
{
  "error": "Listing '12345' is inactive"
}
```

### 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"
}
```
