Skip to main content

Export Efficiency (DORA Metrics)

Last updated on

SEI 2.0 provides APIs to export Efficiency (DORA metrics) in CSV format for teams and organization trees. There are two available APIs:

  • V2 Efficiency Export API (recommended): Asynchronous export API for scalable DORA metric exports.
  • Legacy Reports API: Synchronous CSV export API maintained for backward compatibility.

The V2 Efficiency Export API provides asynchronous exports for DORA metrics including Lead Time for Changes (LTTC), Deployment Frequency (DF), Mean Time to Restore (MTTR), and Change Failure Rate (CFR).

Authentication​

All requests require the following headers:

HeaderValue
authorizationApiKey <YOUR_SEI_API_KEY>
Content-Typeapplication/json

You must also include the following query parameters on all requests:

ParameterDescription
projectIdentifierHarness project identifier
orgIdentifierHarness organization identifier

Export workflow​

Creates a new asynchronous Efficiency export job.

# Replace BASE_URL with your Harness cluster URL
POST {BASE_URL}/v2/insights/efficiency/exports
Request Body
{
  "scope": {
    "teamId": "team_abc123",    // String identifier; use either teamId OR orgTreeName (not both)
    "orgTreeName": "string",
    "orgIdentifier": "string",  // Required when using orgTreeName
    "projectIdentifier": "string"
  },
  "dateRange": {
    "start": "2026-01-01", // Required
    "end": "2026-03-31" // Required
  },
  "metricGroups": ["lttc", "df", "mttr", "cfr"], // Required
  "options": {
    "granularity": "MONTHLY" // Required
  }
}

The following request fields are available:

FieldDescription
scope.teamIdExport data for a specific team.
scope.orgTreeNameExport data for an organization tree.
dateRange.startExport start date (yyyy-MM-dd).
dateRange.endExport end date (yyyy-MM-dd).
metricGroupsSupported DORA metrics such as Lead Time for Changes (lttc), Deployment Frequency (df), Mean Time to Restore (mttr), Change Failure Rate (cfr), or aggregate DORA summary metrics (summary).
metricsIndividual metric columns such as LTTC_Mean_Days or DF_Deployment_Count.
options.granularityReporting interval (WEEKLY, MONTHLY, QUARTERLY).
options.aggregationAggregation method (mean, median, p90, p95).
options.compressionExport compression format (gzip).

Available metric groups​

The following Efficiency metric groups are available:

Metric GroupIncluded Metrics
lttcPLANNING, CODING, REVIEW, BUILD, DEPLOY, LTTC
work_itemsTOTAL_WORK_ITEMS, PR_ASSOCIATIONS, PERCENTAGE_PR_ASSOCIATED
deployment_frequencyDEPLOYMENT_FREQUENCY
cfrTOTAL_SUCCESS, TOTAL_FAILURES, CFR
mttrMTTR
ratingOVERALL_RATING
Example Request
curl -X POST "${BASE_URL}/v2/insights/efficiency/exports?projectIdentifier=${PROJECT_ID}&orgIdentifier=${ORG_ID}" \
  -H "Content-Type: application/json" \
  -H "authorization: ApiKey <YOUR_SEI_API_KEY>" \
  -d '{
    "scope": {
      "teamId": "team_abc123"
    },
    "dateRange": {
      "start": "2026-01-01",
      "end": "2026-03-31"
    },
    "metricGroups": ["lttc", "df", "mttr", "cfr"], // Required
    "options": {
      "granularity": "MONTHLY",
      "format": "csv",
      "compression": "gzip"
    }
  }'
Example Response
{
  "exportId": "exp_2B3C4D5E",
  "status": "QUEUED",
  "createdAt": "2025-05-13T10:00:00Z",
  "message": "Export job created successfully"
}
Existing Export Reused
{
  "exportId": "exp_2B3C4D5E",
  "createdAt": "2026-05-13T09:58:00Z",
  "message": "Using existing export with identical parameters"
}

Downloads are gzip-compressed by default and export responses include team hierarchy information where applicable.