---
schema: rendered-html/v1
title: "Get Issues List with All Values | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-howto-get-issues-with-all-values.html
generated_at: 2026-06-11T14:59:58.446697+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](jetbrains__com__help__youtrack__devportal__api-getting-started.md)
- REST API Reference
- REST API Use Cases
- [Create an Issue](jetbrains__com__help__youtrack__devportal__api-howto-create-issue.md)
- [Create an Issue and Set Custom Fields](jetbrains__com__help__youtrack__devportal__api-howto-create-issue-with-fields.md)
- [Get Issues List with All Values](api-howto-get-issues-with-all-values.html)
- [Get Value for an Issue Custom Field](jetbrains__com__help__youtrack__devportal__api-howto-get-value-for-specific-cf.md)
- Add Value to a Set
- [Update Issue Custom Fields](jetbrains__com__help__youtrack__devportal__api-how-to-update-custom-fields-values.md)
- Update a Text Field Value
- [Clear Values of Custom Fields](jetbrains__com__help__youtrack__devportal__api-how-to-clear-custom-fields-values.md)
- Apply Commands to Issues
- Tag or Untag Issues
- Work with Issue Tags
- Attach Files to an Issue
- Delete an Issue Attachment
- Download an Issue Attachment
- [Link Issues](jetbrains__com__help__youtrack__devportal__api-howto-link-issues.md)
- Get Issue History
- Get a Database Backup
- Add User to Project Team
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Use Cases
3. [Get Issues List with All Values](#0)

# Get Issues List with All Values﻿

Last modified: 07 May 2026

## Use Case﻿

Use the REST API to get a list of issues with their custom field values.

## Summary﻿

To get a list of issues with their custom field values:

1. Use the Read a List of Issues request:

   ```
   GET /api/issues?[fields]
   ```
2. In the `fields` parameter, specify the issue attributes that you want to return, including the relevant attributes of `customFields`.
3. Optionally, use the `query` request parameter to filter the issue list.

## Step-by-Step﻿

Start with a request for a single issue and its custom fields, then use the same pattern for the issues list.

### Get an Issue with Its Custom Fields﻿

1. To get an issue with values of all its custom fields, send a `GET` request to the target issue. You can reference the issue by its `idReadable` value, for example `SP-8`, or by its entity `id`, for example `2-7`.

   ```
   GET /api/issues/{issueID}?[fields]
   ```

   Read more about operations with an issue.
2. The `fields` request parameter is the comma-separated list of attributes to return for the requested entity. In this example, the entity is `Issue`.

   You can request any set of supported attributes of the returned entity. For an issue, see the list of supported attributes.

   In this how-to, we request the following data:

   ```
   fields=id,idReadable,summary,customFields(id,projectCustomField(field(name)),value(name,login,fullName))
   ```

   - `$type` — the entity type. YouTrack returns the `$type` for all entities in the response regardless of whether you specify it in the request explicitly or not.
   - `id` — a unique ID of the returned entity in the database.
   - `idReadable` — the issue ID shown in the UI, for example `SP-8`.
   - `summary` — the issue summary.
   - `customFields` — an attribute of the returned `Issue` entity that contains a collection of the issue custom fields. This is the target of our how-to.
3. The `customFields(...)` expression is part of the `fields` parameter, not a separate query parameter. Here, we request the following attributes for each custom field:

   ```
   customFields(id,projectCustomField(field(name)),value(name,login,fullName))
   ```

   - `projectCustomField` — each `IssueCustomField` contains settings of a `ProjectCustomField` in a particular issue.
   - `field` — each `ProjectCustomField` contains settings of a `CustomField` in a particular project.
   - `projectCustomField(field(name))` — returns the name of the custom field definition, for example `Priority`, `State`, or `Assignee`.
   - `value` — stores the custom field value for the issue. Depending on the field type, it can contain a primitive value, a linked entity, or a collection of values.

   Read more about the custom field hierarchy.

The final request is the following:

```
curl -X GET \
'https://example.youtrack.cloud/api/issues/SP-8?fields=id,idReadable,summary,customFields(id,projectCustomField(field(name)),value(name,login,fullName))' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer perm:amFuZS5kb2U=.UkVTVCBBUEk=.wcKuAok8cHmAtzjA6xlc4BrB4hleaX' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json'
```

The response looks like this:

In this example, the issue contains the following custom fields: `Priority`, `State`, `Assignee`, `Subsystem`, `Fix versions`, and `Fixed in build`.

```
{
    "id":"2-7",
    "idReadable":"SP-8",
    "summary":"Issue from REST #1",
    "$type":"Issue",
    "customFields":[
        {
            "id":"92-1",
            "$type":"SingleEnumIssueCustomField",
            "projectCustomField":{
                "id":"92-1",
                "$type":"EnumProjectCustomField",
                "field":{
                    "id":"58-1",
                    "$type":"CustomField",
                    "name":"Priority"
                },
            },
            "value":{
                "id":"67-3",
                "$type":"EnumBundleElement",
                "name":"Normal"
            }
        },
        {
            "id":"92-3",
            "$type":"StateIssueCustomField",
            "projectCustomField":{
                "id":"92-3",
                "$type":"StateProjectCustomField",
                "field":{
                    "id":"58-3",
                    "$type":"CustomField",
                    "name":"State"
                }
            },
            "value":{
                "id":"69-7",
                "$type":"StateBundleElement",
                "name":"Fixed"
            }
        },
        {
            "id":"94-0",
            "$type":"SingleUserIssueCustomField",
            "projectCustomField":{
                "id":"94-0",
                "$type":"UserProjectCustomField",
                "field":{
                    "id":"58-4",
                    "$type":"CustomField",
                    "name":"Assignee"
                }
            },
            "value":{
                "id":"1-2",
                "$type":"User",
                "name":"John Doe",
                "fullName":"John Doe",
                "login":"john.doe"
            }
        },
        {
            "id":"92-0",
            "$type":"SingleOwnedIssueCustomField",
            "projectCustomField":{
                "id":"92-0",
                "$type":"OwnedProjectCustomField",
                "field":{
                    "id":"58-0",
                    "$type":"CustomField",
                    "name":"Subsystem"
                }
            },
            "value":{
                "id":"134-0",
                "$type":"OwnedBundleElement",
                "name":"Documentation"
            }
        },
        {
            "id":"92-4",
            "$type":"MultiVersionIssueCustomField",
            "projectCustomField":{
                "id":"92-4",
                "$type":"VersionProjectCustomField",
                "field":{
                    "id":"58-5",
                    "$type":"CustomField",
                    "name":"Fix versions"
                }
            },
            "value":[
                {
                    "id":"133-19",
                    "$type":"VersionBundleElement",
                    "name":"2019.1"
                }
            ]
        },
        {
            "id":"92-6",
            "$type":"SingleBuildIssueCustomField",
            "projectCustomField":{
                "id":"92-6",
                "$type":"BuildProjectCustomField",
                "field":{
                    "id":"58-7",
                    "$type":"CustomField",
                    "name":"Fixed in build"
                }
            },
            "value":{
                "id":"135-0",
                "$type":"BuildBundleElement",
                "name":"48733"
            },
        }
    ]
}
```

### Get Issues List with Custom Fields﻿

To return the same data for multiple issues, remove the `{issueID}` from the endpoint URL. For example:

```
curl -X GET \
'https://example.youtrack.cloud/api/issues?fields=id,summary,customFields(id,projectCustomField(field(name)),value(name))' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer perm:amFuZS5kb2U=.UkVTVCBBUEk=.wcKuAok8cHmAtzjA6xlc4BrB4hleaX' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json'
```

To filter the list of returned issues, add the `query` parameter. For example, to return a subset of issues from a specific project:

```
curl -X GET \
'https://example.youtrack.cloud/api/issues?fields=id,idReadable,summary,customFields(id,projectCustomField(field(name)),value(name))&query=in:SP' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer perm:amFuZS5kb2U=.UkVTVCBBUEk=.wcKuAok8cHmAtzjA6xlc4BrB4hleaX' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json'
```

To get a single issue by its readable ID, request it directly, for example: `/api/issues/SP-8?fields=id,idReadable,summary,customFields(id,projectCustomField(field(name)),value(name))`.

For more information about supported search expressions, see Query Syntax.

- [Get Issues List with All Values](/help/youtrack/devportal/api-howto-get-issues-with-all-values.html)
- [Use Case](/help/youtrack/devportal/api-howto-get-issues-with-all-values.html#use-case)
- [Summary](/help/youtrack/devportal/api-howto-get-issues-with-all-values.html#summary)
- [Step-by-Step](/help/youtrack/devportal/api-howto-get-issues-with-all-values.html#step-by-step)

[Create an Issue and Set Custom Fields](jetbrains__com__help__youtrack__devportal__api-howto-create-issue-with-fields.md)[Get Value for an Issue Custom Field](jetbrains__com__help__youtrack__devportal__api-howto-get-value-for-specific-cf.md)

- 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=e22e15ae-61c3-4964-8ed3-6384d32bb77c&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=Get%20Issues%20List%20with%20All%20Values%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Fapi-howto-get-issues-with-all-values.html&r=&lt=585&pt=1781189996140,30,30,,,2,2,2,2,2,,3,26,27,33,172,172,172,584,585,585&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=663715)
