---
title: "Ingest usage events for a meter"
method: POST
path: "/usage/bulk/{meterGlobalId}"
tags: ["Data Ingestion"]
---

# Ingest usage events for a meter

`POST /usage/bulk/{meterGlobalId}`

Ingests usage events directly into Zuora Mediation in real time. You can send a single event or batch multiple events in a JSON array to optimize throughput. Each event must conform to the meter's event schema. This operation is supported only for meters that use the Streaming API as their source in Zuora Mediation. You can use this API to bulk-ingest events into a meter only when the meter's source is configured as a Streaming API operator. For meters that use other sources, use the appropriate ingestion mechanism for that source instead.

## Path parameters

- `meterGlobalId` string, required

## Headers

- `Content-Type` string, required
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string

## Request body

- union
  - StreamingEvent — A usage event to be ingested into Zuora Mediation.
    - `CustomerId` string, required — Unique identifier for the customer.
    - `UsageIdentifier` string, required — Identifier for the usage type.
    - `UsageDate` string, date-time, required — Date and time when the usage occurred.
    - `Quantity` number, required — Quantity of usage.
  - StreamingEvent[]
    - `CustomerId` string, required — Unique identifier for the customer.
    - `UsageIdentifier` string, required — Identifier for the usage type.
    - `UsageDate` string, date-time, required — Date and time when the usage occurred.
    - `Quantity` number, required — Quantity of usage.

## Response `200`

Usage event(s) ingested successfully.

- StreamingIngestionSuccessResponse — Successful ingestion response.
  - `success` boolean — Whether the ingestion was successful.
  - `message` string — Response message with details.

## Other responses

- `400` — Bad request due to validation or business logic errors.
- `401` — Unauthorized request.
- `404` — Resource not found.
- `413` — Payload too large.
- `429` — Too many requests.
- `500` — Internal server error.

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)