For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • REST API overview
    • Access Tokens
    • Account Members
    • Account Usage Beta
      • GETGet AI runs usage
      • GETGet contexts clientside usage
      • GETGet contexts serverside usage
      • GETGet contexts total usage
      • GETGet data export events usage
      • GETGet evaluations usage
      • GETGet events usage
      • GETGet experimentation events usage
      • GETGet experimentation keys usage
      • GETGet MAU clientside usage
      • GETGet MAU SDKs by type
      • GETGet MAU total usage
      • GETGet MAU usage
      • GETGet MAU usage by category
      • GETGet observability errors usage
      • GETGet observability logs usage
      • GETGet observability metrics usage
      • GETGet observability sessions usage
      • GETGet observability traces usage
      • GETGet SDK versions usage details
      • GETGet service connections usage
      • GETGet stream usage
      • GETGet stream usage by SDK version
      • GETGet stream usage SDK versions
      • GETGet usage details for all SDK versions
      • GETGet Vega AI usage
    • AI Configs
    • Announcements
    • Applications Beta
    • Approvals
    • Approvals Beta
    • Audit Log
    • Code References
    • Contexts
    • Context Settings
    • Custom Roles
    • Data Export Destinations
    • Environments
    • Experiments
    • Feature Flags
    • Feature Flags Beta
    • Flag Import Configurations Beta
    • Flag Links Beta
    • Flag Triggers
    • Follow Flags
    • Holdouts Beta
    • Insights Charts Beta
    • Insights Deployments Beta
    • Insights Flag Events Beta
    • Insights Pull Requests Beta
    • Insights Repositories Beta
    • Insights Scores Beta
    • Integration Audit Log Subscriptions
    • Integration Delivery Configurations Beta
    • Integrations Beta
    • Layers
    • Metrics
    • Metrics Beta
    • OAuth2 Clients
    • Persistent Store Integrations Beta
    • Projects
    • Relay Proxy Configurations
    • Release Pipelines Beta
    • Releases Beta
    • Scheduled Changes
    • Segments
    • Tags
    • Teams
    • Teams Beta
    • Users
    • Users Beta
    • User Settings
    • Views Beta
    • Webhooks
    • Workflows
    • Workflow Templates
    • Other
Sign inTry it free
LogoLogo
REST API overviewAccount Usage Beta

Get events usage

GET
/api/v2/usage/events/:type
GET
/api/v2/usage/events/:type
$curl https://app.launchdarkly.com/api/v2/usage/events/type \
>     -H "Authorization: <apiKey>"
1{
2  "_links": {},
3  "metadata": [
4    {}
5  ],
6  "series": [
7    {
8      "0": 11,
9      "1": 15,
10      "time": 1677888000000
11    }
12  ]
13}

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.

Was this page helpful?
Previous

Get experimentation events usage

Next
Built with

Authentication

Authorizationstring
API Key authentication via header

Path parameters

typestringRequiredformat: "string"

The type of event to retrieve. Must be either received or published.

Query parameters

fromstringOptionalformat: "string"
The series of data returned starts from this timestamp. Defaults to 24 hours ago.
tostringOptionalformat: "string"
The series of data returned ends at this timestamp. Defaults to the current time.

Response

Usage response
_linksmap from strings to any
The location and content type of related resources
metadatalist of maps from strings to any
Metadata about each series
serieslist of maps from strings to integers

An array of data points with timestamps. Each element of the array is an object with a ‘time’ field, whose value is the timestamp, and one or more key fields. If there are multiple key fields, they are labeled ‘0’, ‘1’, and so on, and are explained in the metadata.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error