# Issue Sprints

This resource lets you work with the sprints where the issue belongs.
|  Resource  |     ```GENERIC /api/issues/{issueID}/sprints ```    |
| --- | --- |
|  Returned entity  |  [Sprint](api-entity-Sprint.html). For the description of the entity attributes, see [Supported Fields](#Sprint-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Issue Sprints](#get_all-Sprint-method).    |

## Sprint attributes

Represents a sprint that is associated with an agile board. Each sprint can include issues from one or more projects.

### Related Resources

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

* [Sprints](resource-api-agiles-agileID-sprints.html)

* [Issue Sprints]()

### Attributes

This table describes attributes of the `Sprint` 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 sprint. `Read-only`.  |
|  agile  |  [Agile](api-entity-Agile.html)  |  The agile board that the sprint belongs to. `Read-only`. `Can be null`.  |
|  name  |  String  |  Name of the sprint.  |
|  goal  |  String  |  Goal of the sprint. `Can be null`.  |
|  start  |  Long  |  The timestamp in milliseconds indicating the start date of the sprint. Stored as a unix timestamp at UTC. `Can be null`.  |
|  finish  |  Long  |  The timestamp in milliseconds indicating the end date of the sprint. Stored as a unix timestamp at UTC. `Can be null`.  |
|  archived  |  Boolean  |  Indicates whether the sprint is archived.  |
|  isDefault  |  Boolean  |  If `true`, then new issues that match a column on this board are automatically added to this sprint.  |
|  issues  |  [Array of Issues](api-entity-Issue.html)  |  Issues that are present on this sprint.  |
|  unresolvedIssuesCount  |  Int  |  Number of unresolved issues on this sprint. `Read-only`.  |
|  previousSprint  |  [Sprint](api-entity-Sprint.html)  |  If you provide this attribute when you create a new sprint, then all unresolved issues from this sprint will be moved to the newly created sprint.  |

## Read a List of Sprints

Get the list of sprints where the issue belongs.

### Request syntax

```GENERIC
GET /api/issues/{issueID}/sprints?{fields}&{$top}&{$skip}
```

|  null  |  The database ID of Sprint  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of Sprint 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/issues/NP-113/sprints?fields=id,agile(id,name),name,goal,start,finish,archived
```

#### Sample response body

```JSON
[
  {
    "start": null,
    "archived": false,
    "agile": {
      "name": "The product board",
      "id": "87-72",
      "$type": "Agile"
    },
    "goal": "Develop the features",
    "finish": null,
    "name": "Sprint 134",
    "id": "91-703",
    "$type": "Sprint"
  },
  {
    "start": null,
    "archived": false,
    "agile": {
      "name": "The marketing board",
      "id": "87-159",
      "$type": "Agile"
    },
    "goal": "Maintain the marketing materials",
    "finish": null,
    "name": "Q3",
    "id": "91-1317",
    "$type": "Sprint"
  },
  {
    "start": null,
    "archived": false,
    "agile": {
      "name": "Outsource",
      "id": "87-91",
      "$type": "Agile"
    },
    "goal": "Track the freelancers' effort",
    "finish": null,
    "name": "October",
    "id": "91-1325",
    "$type": "Sprint"
  }
  ]
```