This feature is in beta
To use this feature, pass in a header including the
LD-API-Versionkey with value set tobeta. Use this header with each call. To learn more, read Beta resources.
The account usage API lets you query for metrics about how your account is using LaunchDarkly. To learn more, read Account usage metrics.
Each endpoint returns time-series data in the form of an array of data points with timestamps. Each one contains data for that time from one or more series. It also includes a metadata array describing what each of the series is.
Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
Usage response
Invalid request
Invalid access token
Forbidden
Invalid resource identifier
Rate limited
curl -i -X GET \ 'https://app.launchdarkly.com/api/v2/usage/evaluations/{projectKey}/{environmentKey}/{featureFlagKey}' \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "metadata": [
- {
- "property1": null,
- "property2": null
}
], - "series": [
- {
- "property1": 0,
- "property2": 0
}
]
}Get time-series arrays of the number of times a flag is evaluated, broken down by the variation that resulted from that evaluation. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
Usage response
Invalid request
Invalid access token
Forbidden
Invalid resource identifier
Rate limited
curl -i -X GET \ 'https://app.launchdarkly.com/api/v2/usage/events/{type}' \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "metadata": [
- {
- "property1": null,
- "property2": null
}
], - "series": [
- {
- "property1": 0,
- "property2": 0
}
]
}Get a time-series array of the number of monthly active users (MAU) seen by LaunchDarkly from your account. The granularity is always daily.
Usage response
Invalid request
Invalid access token
Forbidden
Rate limited
curl -i -X GET \ https://app.launchdarkly.com/api/v2/usage/mau \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "metadata": [
- {
- "property1": null,
- "property2": null
}
], - "series": [
- {
- "property1": 0,
- "property2": 0
}
]
}Get time-series arrays of the number of monthly active users (MAU) seen by LaunchDarkly from your account, broken down by the category of users. The category is either browser, mobile, or backend.
Usage response
Invalid request
Invalid access token
Forbidden
Invalid resource identifier
Rate limited
curl -i -X GET \ https://app.launchdarkly.com/api/v2/usage/mau/bycategory \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "metadata": [
- {
- "property1": null,
- "property2": null
}
], - "series": [
- {
- "property1": 0,
- "property2": 0
}
]
}Get a list of SDKs. These are all of the SDKs that have connected to LaunchDarkly by monthly active users (MAU) in the requested time period.
MAU SDKs response
Invalid request
Invalid access token
Forbidden
Rate limited
curl -i -X GET \ https://app.launchdarkly.com/api/v2/usage/mau/sdks \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "sdks": [
- "string"
]
}Get a time-series array of the number of streaming connections to LaunchDarkly in each time period. The granularity of the data depends on the age of the data requested. If the requested range is within the past two hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
Usage response
Invalid request
Invalid access token
Forbidden
Invalid resource identifier
Rate limited
curl -i -X GET \ 'https://app.launchdarkly.com/api/v2/usage/streams/{source}' \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "metadata": [
- {
- "property1": null,
- "property2": null
}
], - "series": [
- {
- "property1": 0,
- "property2": 0
}
]
}Get multiple series of the number of streaming connections to LaunchDarkly in each time period, separated by SDK type and version. Information about each series is in the metadata array. The granularity of the data depends on the age of the data requested. If the requested range is within the past 2 hours, minutely data is returned. If it is within the last two days, hourly data is returned. Otherwise, daily data is returned.
Usage response
Invalid request
Invalid access token
Forbidden
Invalid resource identifier
Rate limited
curl -i -X GET \ 'https://app.launchdarkly.com/api/v2/usage/streams/{source}/bysdkversion' \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "metadata": [
- {
- "property1": null,
- "property2": null
}
], - "series": [
- {
- "property1": 0,
- "property2": 0
}
]
}Get a list of SDK version objects, which contain an SDK name and version. These are all of the SDKs that have connected to LaunchDarkly from your account in the past 60 days.
SDK Versions response
Invalid access token
Forbidden
Rate limited
curl -i -X GET \ 'https://app.launchdarkly.com/api/v2/usage/streams/{source}/sdkversions' \ -H 'Authorization: YOUR_API_KEY_HERE'
{- "_links": {
- "property1": null,
- "property2": null
}, - "sdkVersions": [
- {
- "sdk": "string",
- "version": "string"
}
]
}