Skip to main content
GET
/
v1
/
projects
/
{projectId}
/
flags
/
{flagKey}
/
usage
curl "https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../flags/new-checkout/usage?environmentId=env_01hx...&from=2024-04-01&to=2024-04-07" \
  -H "Authorization: Bearer <server_key>"

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-04-01",
  "to": "2024-04-07",
  "rows": [
    {
      "date": "2024-04-01",
      "totalEvaluations": 14823,
      "valueDistribution": { "true": 7200, "false": 7623 },
      "ruleMatchCount": 7200,
      "defaultCount": 7623,
      "errorCount": 0
    }
  ]
}
Analytics are aggregated nightly by a background job. Data is not real-time. Retention: clamped to your plan’s analytics window (7 days on Free, 90 days on Pro/Enterprise).

​
Path parameters

​
projectId
string
required
​
flagKey
string
required

​
Query parameters

​
environmentId
string
required
The environment to query.
​
from
string
Start date in YYYY-MM-DD format. Defaults to 29 days ago.
​
to
string
End date in YYYY-MM-DD format. Defaults to today. Maximum range is 90 days.

​
Response

​
flagKey
string
required
​
environmentId
string
required
​
from
string
required
Effective start date after plan retention clamping. May differ from the requested from.
​
to
string
required
​
clampedFrom
boolean
Present and true when the requested from was earlier than your plan’s retention window and was silently clamped. Absent when no clamping occurred.
​
rows
UsageDay[]
required
One entry per day that had evaluations. Days with zero evaluations are omitted.
Each UsageDay:
FieldTypeDescription
datestringYYYY-MM-DD
totalEvaluationsnumber
valueDistributionRecord<string, number>Value → count map
ruleMatchCountnumberEvaluations resolved by a rule
defaultCountnumberEvaluations resolved by defaultValue
errorCountnumberEvaluations that returned ERROR reason
curl "https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../flags/new-checkout/usage?environmentId=env_01hx...&from=2024-04-01&to=2024-04-07" \
  -H "Authorization: Bearer <server_key>"

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-04-01",
  "to": "2024-04-07",
  "rows": [
    {
      "date": "2024-04-01",
      "totalEvaluations": 14823,
      "valueDistribution": { "true": 7200, "false": 7623 },
      "ruleMatchCount": 7200,
      "defaultCount": 7623,
      "errorCount": 0
    }
  ]
}