Menu

Usage

1 endpoint in the Mattering Productivity API. Service tier only.

GET usage/ Service tier

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

NameDefault
organization_idnone

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

StatusCode
400missing 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)

All Productivity resources
Start Free Explore our Products