Get

GET

/launch-analytics

GET

/api/v1/launch-analytics

curl https://api.taktoria.com/api/v1/launch-analytics \
     -H "Authorization: Bearer <token>"

{
  "period": {
    "year": 1,
    "quarter": 1
  },
  "shipped": {
    "launched": 1,
    "onTime": 1,
    "late": 1,
    "previous": 1,
    "onTimeRate": 1,
    "medianDaysLate": 1.1,
    "medianLeadDays": 1.1
  },
  "quarters": [
    {
      "year": 1,
      "quarter": 1,
      "onTime": 1,
      "late": 1
    },
    {
      "year": 1,
      "quarter": 1,
      "onTime": 1,
      "late": 1
    }
  ],
  "inFlight": {
    "total": 1,
    "byStatus": [
      {
        "status": "SCOPING",
        "count": 1
      },
      {
        "status": "SCOPING",
        "count": 1
      }
    ],
    "byHealth": {
      "ON_TRACK": 1,
      "AT_RISK": 1,
      "OFF_TRACK": 1,
      "NONE": 1
    }
  },
  "reviews": [
    {
      "teamId": "teamId",
      "team": "team",
      "teamSlug": "teamSlug",
      "decided": 1,
      "approved": 1,
      "denied": 1,
      "exceptions": 1,
      "decidedByDue": 1,
      "overdue": 1,
      "decidedByDueRate": 1
    },
    {
      "teamId": "teamId",
      "team": "team",
      "teamSlug": "teamSlug",
      "decided": 1,
      "approved": 1,
      "denied": 1,
      "exceptions": 1,
      "decidedByDue": 1,
      "overdue": 1,
      "decidedByDueRate": 1
    }
  ],
  "sentiment": {
    "POSITIVE": 1,
    "NEUTRAL": 1,
    "NEGATIVE": 1
  },
  "upcoming": {
    "months": [
      {
        "month": "month",
        "count": 1
      },
      {
        "month": "month",
        "count": 1
      }
    ],
    "onHolidays": [
      {
        "id": "id",
        "name": "name",
        "date": "2023-01-15",
        "holidays": [
          "holidays",
          "holidays"
        ]
      },
      {
        "id": "id",
        "name": "name",
        "date": "2023-01-15",
        "holidays": [
          "holidays",
          "holidays"
        ]
      }
    ]
  }
}

How launches have shipped, where reviews hold them up, and what is coming: what LaunchCal’s Analytics page shows. Requires launches:read. Without year, the period numbers cover all time.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

yearintegerOptional

A fiscal year, as the workspace's fiscal year start names it.

quarterintegerOptional

A fiscal quarter, 1 to 4, of year. Needs year; left out, the whole year.

Response

This endpoint returns an object.

periodobject

The fiscal period the period numbers cover; both absent for all time.

shippedobject

Launches that shipped in the period, and how they did against their planned dates.

quarterslist of objects

The eight fiscal quarters ending with the chosen one (the year’s last, or this one for all time), oldest first.

inFlightobject

Published launches that have neither launched nor been put on hold, as of now.

reviewslist of objects

Every functional team with a decision in the period or a review overdue.

sentimentobject

Insights recorded in the period, by sentiment.

upcomingobject

Launches in flight planned for this month and the five after it.

Errors

401

Unauthorized Error

422

Validation Error

429

Too Many Requests Error