---
schema: rendered-html/v1
title: "Activity Items | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/resource-api-activities.html
generated_at: 2026-06-11T15:08:26.090573+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- Get Started with REST API
- REST API Reference
- Entities
- Resources
- [Activity Items](resource-api-activities.html)
- Operations with Specific ActivityItem
- [Issue Activities Page](jetbrains__com__help__youtrack__devportal__resource-api-activitiespage.md)
- [Build Bundles](jetbrains__com__help__youtrack__devportal__resource-api-admin-customfieldsettings-bundles-build.md)
- [Enum Bundles](jetbrains__com__help__youtrack__devportal__resource-api-admin-customfieldsettings-bundles-enum.md)
- [Owned Bundles](jetbrains__com__help__youtrack__devportal__resource-api-admin-customfieldsettings-bundles-ownedfield.md)
- [State Bundles](jetbrains__com__help__youtrack__devportal__resource-api-admin-customfieldsettings-bundles-state.md)
- User Bundles
- Version Bundles
- Custom Fields
- Field Types
- Backup Files
- Database Backup Settings
- Global Settings
- Organizations
- Projects
- Telemetry data
- Global Time Tracking Settings
- Agiles
- Articles
- Assigned Roles
- Commands
- Command Suggestions
- User Groups
- Issue Link Types
- Issue Tag
- Issues
- Issue Count
- Permissions
- Roles
- Saved Queries
- Search Suggestions
- Tags
- Users
- My User Profile
- Issue Work Items
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Reference
3. Resources
4. [Activity Items](#0)

# Activity Items﻿

Last modified: 24 March 2026

This resource provides access to the activities with the possibility to filter them by various parameters.

| Resource | ``` /api/activities ``` |
| --- | --- |
| Returned entity | ActivityItem. For the description of the entity attributes, see [Supported Fields](/help/youtrack/devportal/resource-api-activities.html#ActivityItem-supported-fields) section. |
| Supported methods | - `GET`: [Read a List of ActivityItems](/help/youtrack/devportal/resource-api-activities.html#get_all-ActivityItem-method). |

## ActivityItem attributes﻿

Represents a change in an issue or in its related entities. In the YouTrack UI, you see these changes in the activity stream. It shows a list of all changes related to this issue: the issue history, comments, attachments, VCS changes, work items, and so on.

### Related Resources﻿

Below you can find the list of resources that let you work with this entity.

- Activities
- Issue Activity Items

### Attributes﻿

This table describes attributes of the `ActivityItem` entity.

- To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.
- To update an attribute, provide it in the body of a POST request.

| Field | Type | Description |
| --- | --- | --- |
| id | String | The ID of the activity item. `Read-only`. |
| added |  | Single value or the list of values which were added to a property of the target entity. `Read-only`. |
| author | User | The user who performed the action. `Read-only`. |
| category | ActivityCategory | The category of the activity. `Read-only`. |
| field | FilterField | The filter field. It contains the additional information about the modified property in the target entity. For example, the information about a link type, or the type of the modified custom field or bundle, and so on. `Read-only`. `Can be null`. |
| removed |  | Single value or the list of values which were removed from a property of the target entity. `Read-only`. |
| target |  | The entity that is the target of the performed action. `Read-only`. |
| targetMember | String | The name of the property of the target entity, which was modified. `Read-only`. `Can be null`. |
| timestamp | Long | The timestamp of the activity event. Stored as a unix timestamp at UTC. `Read-only`. |

## Read a List of ActivityItems﻿

Get the list of all available activities.

### Request syntax﻿

```
GET /api/activities?{fields}&{$top}&{$skip}&{categories}&{reverse}&{start}&{end}&{author}&{issueQuery}
```

| null | The database ID of ActivityItem |
| --- | --- |

### Request parameters﻿

| Parameter | Type | Description |
| --- | --- | --- |
| fields | String | A list of ActivityItem attributes that should be returned in the response. If no field is specified, only the `entityID` is returned. |
| $skip | Int | Optional. Lets you set a number of returned entities to skip before returning the first one. |
| $top | Int | Optional. Lets you specify the maximum number of entries that are returned in the response. If you don't set the $top value, the server limits the maximum number of returned entries.  The server returns a maximum of 42 entries for most resources that return collections. For more information, see Pagination. |
| categories | String | Mandatory. Parameter filters returned activities by categories. You must specify at least one category per request.  You can specify the `categories` query parameter in either of these formats:   - `categories=IssueCreatedCategory&categories=CommentsCategory` - `categories=IssueCreatedCategory,CommentsCategory`   See this table for mapping between available categories and returned types of activity items. |
| reverse | Boolean | Indicates whether the order of returning activities is from newest to oldest or the opposite. If `false`, then the oldest activity item that matches a selected filter is returned first. If `true`, then the newest activity is returned first. By default, `false`. |
| start | String | The timestamp in milliseconds indicating the start of the time interval the activity timestamp belongs to. Stored as a unix timestamp at UTC. If the parameter is not set, it is considered to be 0. |
| end | String | The timestamp in milliseconds indicating the end of the time interval the activity timestamp belongs to. Stored as a unix timestamp at UTC. If the parameter is not set, it is considered as `Long.MAX_VALUE`. |
| author | String | Parameter to filter activities by the author. You can specify one of the following parameters: the database ID, login, Hub ID, or `me` for the currently logged in user. |
| issueQuery | String | Issue search query. For details about search syntax, refer to the YouTrack documentation. |

### Sample﻿

#### Sample request﻿

```
https://example.youtrack.cloud/api/activities?fields=id,author(id,login,name),timestamp,added(id,idreadable),target(id,idReadable)&categories=IssueCreatedCategory,CommentsCategory&$skip=30&$top=3
```

#### Sample response body﻿

```
[
    "added": [
        "id": "4-2",
        "$type": "IssueComment"
      }
    ],
    "id": "4-2.0-0",
    "author": {
      "login": "john.doe",
      "name": "John Doe",
      "id": "1-2",
      "$type": "User"
    "timestamp": 1533221614364,
    "target": {
      "id": "4-2",
      "$type": "IssueComment"
    "$type": "CommentActivityItem"
    "added": [],
    "id": "2-32.0-0",
    "target": {
      "idReadable": "SP-33",
      "id": "2-32",
      "$type": "Issue"
    "author": {
      "login": "john.doe",
      "name": "John Doe",
      "id": "1-2",
      "$type": "User"
    "timestamp": 1534186348819,
    "$type": "IssueCreatedActivityItem"
    "added": [
        "id": "4-3",
        "$type": "IssueComment"
      }
    ],
    "id": "4-3.0-0",
    "author": {
      "login": "john.doe",
      "name": "John Doe",
      "id": "1-2",
      "$type": "User"
    "timestamp": 1535547095738,
    "target": {
      "id": "4-3",
      "$type": "IssueComment"
    "$type": "CommentActivityItem"
  }
]
```

- [Activity Items](/help/youtrack/devportal/resource-api-activities.html)
- [ActivityItem attributes](/help/youtrack/devportal/resource-api-activities.html#ActivityItem-supported-fields)
- [Read a List of ActivityItems](/help/youtrack/devportal/resource-api-activities.html#get_all-ActivityItem-method)

ResourcesOperations with Specific ActivityItem

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.

![](https://bat.bing.com/action/0?ti=5220035&tm=gtm002&Ver=2&mid=96f979dc-d34c-47eb-bb4a-2a6831cfe68f&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=Activity%20Items%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Fresource-api-activities.html&r=&lt=1101&pt=1781190503008,64,64,,,1,1,1,1,1,,2,60,61,67,294,294,294,1099,1100,1101&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=406535)
