## List the activity of an item

`GET https://getkollek.com/api/items/{item}/logs`

Retrieve everything that has been done to an item, most recent first. Entries are recorded automatically as actions are performed, so they cannot be created, changed or deleted through the API.

Each entry carries the `action` that was performed, the `user_name` of whoever performed it, and a `description` already translated into the language of your account. A user who has since been deleted leaves the name recorded at the time of the action.

The `parameters` object holds whatever the action recorded, and its shape depends on the action. A `label` names something the action applied to, such as a tag. A `file` names an uploaded file. A `changes` array lists the values that moved, each with a `label` and the `from` and `to` values (either may be null when the value was not set). Treat `parameters` as free form: new keys may be added over time.

**Permissions:** Any member of the account.

### Path parameters

- `item` (integer, required): The ID of the item the entry belongs to.

### Query parameters

- `per_page` (integer, optional): The number of entries to return per page, between 1 and 100. Default: `10`.
- `page` (integer, optional): The page number to return. Default: `1`.

**Returns:** A paginated list of item activity objects, or 404 when the item does not belong to your account.

### Example request

```bash
curl https://getkollek.com/api/items/1/logs \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json"
```

### Example response

`Status: 200`

```json
{
    "data": [
        {
            "type": "item_log",
            "id": "3",
            "attributes": {
                "user_name": "Monica Geller",
                "action": "copy_updated",
                "parameters": {
                    "changes": [
                        {
                            "label": "Estimated value",
                            "from": "$390",
                            "to": "$420"
                        }
                    ]
                },
                "description": "updated a copy",
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/items/1/logs/3"
            }
        },
        {
            "type": "item_log",
            "id": "2",
            "attributes": {
                "user_name": "Monica Geller",
                "action": "tag_attached",
                "parameters": {
                    "label": "Signed"
                },
                "description": "added the tag",
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/items/1/logs/2"
            }
        },
        {
            "type": "item_log",
            "id": "1",
            "attributes": {
                "user_name": "Rachel Green",
                "action": "item_created",
                "parameters": null,
                "description": "created this item",
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/items/1/logs/1"
            }
        }
    ],
    "links": {
        "first": "https://getkollek.com/api/items/1/logs?page=1",
        "last": "https://getkollek.com/api/items/1/logs?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://getkollek.com/api/items/1/logs?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://getkollek.com/api/items/1/logs",
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}
```