# List what’s new

`GET /api/v1/changelog-entries`

List the changes published over the last 30 or 90 days, newest day first.

Within a day, features and improvements come before fixes, each newest first. A change scheduled for later is left out until it is published. Reading the list does not mark anything as seen.

This endpoint also answers QUERY, with the same parameters sent in the request body. [How QUERY works](https://my.monicahq.com/docs/api/query-method).

## Query parameters

- `period` (integer, optional, defaults to 30): How many days back to reach: 30 or 90. Any other value reads as 30.
- `page` (integer, optional, defaults to 1): Which page to answer with.
- `per_page` (integer, optional, defaults to 25): How many records one page holds, between 1 and 100. A number outside the range is brought back into it rather than refused.

## Returns

A page of change objects, how many there are in all, and in meta what the period holds.

- `data` (array): The changes on this page. An empty list rather than an error when there are none.
- `data[]` (object): One change.
- `data[].type` (string): Always changelog_entry. It names the kind of record, so a caller holding several kinds can tell them apart without looking at where they came from.
- `data[].id` (string): The id of this record, as a string even when it reads as a number. It is what every endpoint naming this record takes.
- `data[].attributes` (object): Everything the record holds.
- `data[].attributes.entry_type` (string): feature, improvement or fix.
- `data[].attributes.area` (string): The part of the product the change touches, in your language, or null.
- `data[].attributes.title` (string): What changed, in one line, in your language.
- `data[].attributes.body` (string): The explanation, as Markdown, in your language.
- `data[].attributes.body_html` (string): The same explanation, turned into HTML.
- `data[].attributes.link` (string): The absolute address of the screen the change concerns, or null.
- `data[].attributes.day` (date): The day the change was published, as YYYY-MM-DD, in UTC.
- `data[].attributes.is_seen` (boolean): Whether you have seen it. A change published before you joined counts as seen.
- `data[].attributes.my_vote` (string): up or down when you voted on the change, or null.
- `data[].attributes.comment_count` (integer): How many comments everybody can read under the change. Private comments and comments hidden by an administrator are not counted.
- `data[].attributes.published_at` (timestamp): When the change was published, as a count of seconds since 1970.
- `meta` (object): Where you are in the collection.
- `meta.page` (integer): The page this is, counting from 1.
- `meta.per_page` (integer): How many one page holds, which is the size that was asked for once it has been brought into the allowed range.
- `meta.total` (integer): How many changes there are in all, not how many are on this page.
- `data[].links` (object): Where to find more about this change.
- `data[].links.comments` (string): The absolute address the comments of the change are read from.
- `data[].links.web` (string): The What’s new screen in the application, which opens for somebody signed in rather than for a key. It is the link to give a person.
- `meta.period` (integer): How many days back the list reaches: 30 or 90.
- `meta.unseen_count` (integer): How many published changes you have not seen yet, over the whole history rather than the period.
- `meta.days` (integer): On how many different days the changes of the period were published.
- `meta.features` (integer): How many changes of the period are features.
- `meta.improvements` (integer): How many changes of the period are improvements.
- `meta.fixes` (integer): How many changes of the period are fixes.

## Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in `X-RateLimit-Remaining`.

## Request

```sh
curl https://my.monicahq.com/api/v1/changelog-entries \
  -H "Authorization: Bearer $MONICA_TOKEN"
```

```javascript
const response = await fetch('https://my.monicahq.com/api/v1/changelog-entries', {
  headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
```

```php
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/changelog-entries');
```

## Response

`200`

```json
{
    "data": [
        {
            "type": "changelog_entry",
            "id": "01M7NBFWK5XNH908RFDGEAJXKN",
            "attributes": {
                "entry_type": "feature",
                "area": "Contacts",
                "title": "Book the conference room from a contact",
                "body": "Michael can now book the conference room **straight** from a contact page.",
                "body_html": "<p>Michael can now book the conference room <strong>straight</strong> from a contact page.</p>",
                "link": "https://my.monicahq.com/vaults",
                "day": "2026-11-16",
                "is_seen": false,
                "my_vote": "up",
                "comment_count": 2,
                "published_at": 1794819600
            },
            "links": {
                "comments": "https://my.monicahq.com/api/v1/changelog-entries/01M7NBFWK5XNH908RFDGEAJXKN/comments",
                "web": "https://my.monicahq.com/changelog"
            }
        },
        {
            "type": "changelog_entry",
            "id": "01M7NBFWK7BEESY8WABBMXF3E6",
            "attributes": {
                "entry_type": "fix",
                "area": "Contacts",
                "title": "The fax machine no longer eats long notes",
                "body": "A note longer than 10,000 characters lost its last paragraph.",
                "body_html": "<p>A note longer than 10,000 characters lost its last paragraph.</p>",
                "link": null,
                "day": "2026-11-16",
                "is_seen": true,
                "my_vote": null,
                "comment_count": 0,
                "published_at": 1794816000
            },
            "links": {
                "comments": "https://my.monicahq.com/api/v1/changelog-entries/01M7NBFWK7BEESY8WABBMXF3E6/comments",
                "web": "https://my.monicahq.com/changelog"
            }
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total": 2,
        "period": 30,
        "unseen_count": 1,
        "days": 1,
        "features": 1,
        "improvements": 0,
        "fixes": 1
    }
}
```
