Get usage

GET/usage

account:read EnterpriseOpen GuestSince v2

What the account has used: API requests over the last 30 days, day by day and by website (live keys only; sandbox requests are never counted, so a sandbox key gets an empty window) and, on Open Guest, this billing period's guest projects, what they come to and the budget.

guestProjects.count belongs to the period it was counted in: after a renewal it is 0 until the first guest of the new period, and spend is the base fee.

Request

curl 'https://api.measuremaponline.com/api/v2/usage' \
  -H "Authorization: $MMO_API_KEY"

Response

{
  "type": "usage",
  "environment": "live",
  "requests": {
    "windowDays": 30,
    "total": 1284,
    "byDay": [
      {
        "date": "2026-10-24",
        "count": 61
      },
      {
        "date": "2026-10-25",
        "count": 48
      }
    ],
    "domains": [
      {
        "host": "www.example.com",
        "count": 1102
      },
      {
        "host": "quotes.example.com",
        "count": 182
      }
    ]
  },
  "guestProjects": {
    "periodStart": 1791200000000,
    "periodEnd": 1793800000000,
    "count": 3,
    "freeProjects": 0,
    "baseFee": 100,
    "unitPrice": 0.5,
    "spend": 101.5,
    "currency": "EUR",
    "budget": {
      "limitEnabled": true,
      "limit": 200,
      "warningEnabled": true,
      "warning": 150
    },
    "limitReached": false
  }
}

Responses

Usage:
- typestringrequired
  Always"usage"
- environmentstringrequired
  Which world the key, and everything made with it, belongs to. See Live and sandbox.
  One oflivesandbox
- requestsobjectrequired
  API requests by the account's live keys, embeds included. Sandbox requests are never counted.
- guestProjectsobject
  Open Guest only. This billing period's guest projects and what they come to.

Errors

A failed request answers with one of these, in an Error body.

403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.

403invalid_api_keyNo key was sent in the Authorization header, or the key is unknown, revoked, or past the time it kept working after being replaced.

403invalid_subscriptionYour plan has no API access. The API is part of the Enterprise and Open Guest plans.

403subscription_expiredYour subscription is not active. Update your payment method in the app.

Try it

API key

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

GET https://api.measuremaponline.com/api/v2/usage

Fill in your API key to send.

As a cURL command

Shell

curl 'https://api.measuremaponline.com/api/v2/usage' \
  -H "Authorization: $MMO_API_KEY"