---
title: "Preview Stripe usage meter events from tenant usage rollup"
method: GET
path: "/billing/usage-meter-events"
---

# Preview Stripe usage meter events from tenant usage rollup

`GET /billing/usage-meter-events`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/billing/usage-meter-events`
- Auth: HTTP bearer

## Response `200`

Redacted usage meter event preview

- object
  - `schema_version` 'gravityads.stripe_usage_meter_events.v1', required
  - `status` 'stripe_usage_meter_events_ready' | 'usage_not_metered', required
  - `tenant_id` string
  - `event_name` string
  - `payload_mode` 'redacted_preview', required
  - `preview_only` true, required
  - `worker_send_required` boolean, required
  - `stripe_customer_id_present` boolean
  - `stripe_customer_id_hash` string
  - `send_payload_redacted` true, required
  - `worker_only_raw_fields` string[]: Fields available only inside the billing worker send payload.
  - `event_count` integer, required
  - `events` object[], required
    - `event_name` string, required
    - `identifier` string, required
    - `payload_mode` 'redacted_preview', required
    - `payload` object, required
      - `tenant_id` string, required
      - `usage_date` string, date, required
      - `value` integer, required
      - `stripe_customer_id_present` boolean, required
      - `stripe_customer_id_hash` string, required: Short SHA-256 hash prefix; raw cus_* ids are not returned.
      - `input_tokens` integer
      - `output_tokens` integer
      - `cache_read_tokens` integer
      - `cache_write_tokens` integer
      - `estimated_cost_micros` integer: Pass-through upstream cost metadata when provided.
    - `ready_to_send` false, required
    - `send_ready_if_unredacted` boolean, required
  - `stripe_api_called` false
  - `raw_customer_ids_returned` false, required
  - `raw_secrets_returned` false

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)