Return a per-feature usage snapshot for the supplied ``organization_id``.
Secured by InternalAPIGuard (X-Internal-Secret) since this is a cross-service read. Shape:
{
"tier": "free",
"limits": {"<feature_key>": {"cap": int|null, "current": int|null}, ...},
"summary": {
"spaces": int, "projects": int, "tasks": int,
"recordings": int, "storage_bytes": int, "members": int,
}
}The platform calls this from its usage view to render a "Productivity" panel below the existing Automations / AI panels.
URL
- Service tierhttps://productivity.mattering.io/api/internal/usage/
Query parameters
| Name | Default |
|---|---|
organization_id | none |
Responses
200 bare JSON object (no envelope)
{
"tier": "...",
"plan_status": "...",
"productivity_seat_count": "...",
"limits": {},
"summary": {
"spaces": [
"..."
],
"projects": 0,
"tasks": 0,
"recordings": 0,
"storage_bytes": 0,
"members": 0
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | missing organization_id message |
Example
curl -X GET "https://productivity.mattering.io/api/internal/usage/?organization_id=..." \ -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \ -H "X-Internal-Org-Id: $ORG_ID" \ -H "X-Internal-User-Email: you@example.com"
Source: MatteringPMCore/internal_api.py (internal_api.internal_usage_summary)