# Saved Queries

This resource lets you get the list of saved searches that the specific user created.
|  Resource  |     ```GENERIC /api/users/{userID}/savedQueries ```    |
| --- | --- |
|  Returned entity  |  [SavedQuery](api-entity-SavedQuery.html). For the description of the entity attributes, see [Supported Fields](#SavedQuery-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Read a List of SavedQueries](#get_all-SavedQuery-method).    |

## SavedQuery attributes

Represents a saved search.

### Related Resources

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

* [Saved Queries](resource-api-savedQueries.html)

* [Saved Queries of a User]()

Extends [WatchFolder](api-entity-WatchFolder.html)

### Attributes

This table describes attributes of the `SavedQuery` 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 saved search. `Read-only`.  |
|  query  |  String  |  The query that is saved in this search. `Can be null`.  |
|  issues  |  [Array of Issues](api-entity-Issue.html)  |  The collection of issues that match this saved search. `Read-only`.  |
|  visibleFor  |  [UserGroup](api-entity-UserGroup.html)  |    Deprecated. Use the `readSharingSettings` attribute instead.  Group of users that can see this saved search. If the saved search is visible only to its owner, this property is null.   `Can be null`.  |
|  updateableBy  |  [UserGroup](api-entity-UserGroup.html)  |    Deprecated. Use the `updateSharingSettings` attribute instead.  Group of users that can update this saved search. If only the owner of the saved search can update it, this property is null.   `Can be null`.  |
|  readSharingSettings  |  [WatchFolderSharingSettings](api-entity-WatchFolderSharingSettings.html)  |  Users and groups that can see this saved search. If the saved search is visible only to its owner, this property contains an empty array. `Read-only`.  |
|  updateSharingSettings  |  [WatchFolderSharingSettings](api-entity-WatchFolderSharingSettings.html)  |  Users and groups that can update this saved search. If only the owner of the saved search can update it, this property contains an empty array. `Read-only`.  |
|  owner  |  [User](api-entity-User.html)  |  The user who created the watch folder. `Read-only`. `Can be null`.  |
|  name  |  String  |  The name of the issue folder.  |

## Read a List of SavedQueries

Get the list of all saved searches that this user created.

### Request syntax

```GENERIC
GET /api/users/{userID}/savedQueries?{fields}&{$top}&{$skip}
```

|  null  |  The database ID of SavedQuery  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of SavedQuery 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](api-concept-pagination.html).     |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/users/1-2/savedQueries?fields=query,id,name,visibleFor(id,name),isUpdateable,owner(id,name)&$top=3
```

#### Sample response body

```JSON
[
  {
    "query": "project: RAP #Unassigned",
    "visibleFor": null,
    "owner": {
      "name": "John Doe",
      "id": "1-2",
      "$type": "User"
    },
    "name": "Unassigned in RAP",
    "id": "51-4",
    "$type": "SavedQuery"
  },
  {
    "query": "project: RP #Unassigned",
    "visibleFor": null,
    "owner": {
      "name": "John Doe",
      "id": "1-2",
      "$type": "User"
    },
    "name": "Unassigned in RP",
    "id": "51-7",
    "$type": "SavedQuery"
  },
  {
    "query": "project: GRP #Unassigned",
    "visibleFor": null,
    "owner": {
      "name": "John Doe",
      "id": "1-2",
      "$type": "User"
    },
    "name": "Unassigned in GRP",
    "id": "51-8",
    "$type": "SavedQuery"
  }
]
```