YouTrack API for Java

🧚‍ Java library to interact with YouTrack’s REST API.


// Import classes:
import dev.floofy.libs.youtrack.api.ApiClient;
import dev.floofy.libs.youtrack.api.ApiException;
import dev.floofy.libs.youtrack.api.Configuration;
import dev.floofy.libs.youtrack.api.auth.*;
import dev.floofy.libs.youtrack.api.models.*;
import dev.floofy.libs.youtrack.api.openapi.DefaultApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();

        // Configure HTTP bearer authorization: permanentToken
        HttpBearerAuth permanentToken = (HttpBearerAuth) defaultClient.getAuthentication("permanentToken");
        permanentToken.setBearerToken("BEARER TOKEN");

        DefaultApi apiInstance = new DefaultApi(defaultClient);
        String categories = "categories_example"; // String | 
        Boolean reverse = true; // 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\".
        String start = "start_example"; // String | Start timestamp of the time interval the activity timestamp belongs to. If the parameter is not set, it is considered to be 0.
        String end = "end_example"; // String | End timestamp of the time interval the activity timestamp belongs to. If the parameter is not set, it is considered as Long.MAX_VALUE.
        String author = "author_example"; // String | Parameter to filter activities by the author. The database id or login, or Hub id, or 'me' for the current logged in user could be specified.
        String issueQuery = "issueQuery_example"; // String | Issues search query. Read more about <a href=\"Search-and-Command-Attributes.xml\">search syntax</a>.
        String fields = "$type,added,author($type,id,login,name,ringId),category($type,id),field($type,customField($type,fieldType($type,id),id,localizedName,name),id,name),id,removed,target,targetMember,timestamp"; // String | 
        Integer $skip = 56; // Integer | 
        Integer $top = 56; // Integer | 
        try {
            List<ActivityItem> result = apiInstance.activitiesGet(categories, reverse, start, end, author, issueQuery, fields, $skip, $top);
        } catch (ApiException e) {
            System.err.println("Exception when calling DefaultApi#activitiesGet");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());



Version: 1.2.0


Kotlin DSL

repositories {
    maven {
        url = uri("")

dependencies {

Groovy DSL

repositories {
    maven {
        url ""

dependencies {
    implementation "dev.floofy.youtrack:youtrack-api:<VERSION>"





youtrack-kotlin-api is released under the MIT License.