List Timeframes

Returns timeframes (years/sprints) and their periods (quarters/months). Use the period key value (e.g. 2026_Q1) as startQuarter/endQuarter when creating or filtering initiatives.

GET /timeframes

List all timeframes with their periods

cURL

curl --request GET \
  --url https://crossproductroadmapbackend.vercel.app/api/v1/timeframes \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-slug: <x-tenant-slug>'

200

{
  "timeframes": [
    {
      "id": "<string>",
      "label": "2026",
      "year": "2026",
      "startDate": "2023-11-07T05:31:56Z",
      "endDate": "2023-11-07T05:31:56Z",
      "quarters": [
        {
          "id": "<string>",
          "key": "2026_Q1",
          "label": "Q1",
          "fullLabel": "2026 Q1",
          "startDate": "2023-11-07T05:31:56Z",
          "endDate": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ]
}

Authorizations

ApiKeyAuthOAuthBearer

Authorization · string · header · required

Generate an API key in your workspace Settings → API Keys. Pass it as Authorization: Bearer tab_<key> on every request.

Headers

x-tenant-slug · string · required

Your workspace slug (e.g. acme).

Response

200

application/json

OK

timeframes · object[]

Show child attributes