Metering & Billing

Metering export

Pull raw usage data on your schedule — daily CSV emails or a self-serve HTTP endpoint for your internal tooling.

Daily CSV email

Every 24 hours Meridian compiles the previous day’s metering records into a gzip-compressed CSV and delivers it to the billing contact on your account. The file lands in your inbox by 02:00 UTC.

CSV columns

  • date, license_key_hash, meter_event, quantity, timestamp_utc

Enable or change the recipient under Billing settings.

Self-serve programmatic export

For teams that pipe usage into internal dashboards or billing systems, Meridian exposes a read-only CSV endpoint. Authenticate with a scoped API key and fetch on your own cadence.

Endpoint

GET https://api.getnimbus.net/v1/usage.csv

Headers

Authorization: Bearer <api_key>

Query parameters

  • from — ISO-8601 start (inclusive)
  • to — ISO-8601 end (inclusive)
  • tz — IANA timezone (default UTC)

Example request

curl -H "Authorization: Bearer $MERIDIAN_API_KEY" \
  "https://api.getnimbus.net/v1/usage.csv?from=2026-01-01&to=2026-01-31"

API keys are scoped per product. Generate one in API key settings.

Rate limits

  • 60 requests/min per API key
  • 90-day maximum window per request
  • CSV payloads capped at 50 MB; paginate with narrower windows if needed
← DocsMetering events →