Is there a way to get the current sprint name using the VersionOne API?

Question

I know that Sprint in the UI maps to the underlying asset types called Timebox. And I know I can get the Name of a Timebox using the rest-1.v1/Data endpoint:

<Server Base URI>/rest-1.v1/Data/Timebox?sel=Name&page=10,0

When I examine the metadata, I can see that it has BeginDate and EndDate. Do I have to compare those to Now() to get the current sprint?

Answer 1

No. You can use the State of the Timebox:

<Server Base URI>/rest-1.v1/Data/Timebox?where=State.Code='ACTV'&sel=Name,StartDate,EndDate,State

This depends on using the UI to properly close completed sprints and activate the next one.