---
title: "Record meter events in bulk"
method: POST
path: "/v1/sdk/meter-events/bulk"
tags: ["Meter Events"]
---

# Record meter events in bulk

`POST /v1/sdk/meter-events/bulk`

Persists the events with bulkRecordUsage (which records each event like the single POST), after shared meter/customer checks.

## Request body

- RecordBulkMeterEventsZodDto
  - `events` object[], required
    - `customerRef` string, required
    - `meterName` string, required
    - `productRef` string
    - `properties` object
    - `timestamp` string
    - `value` number

## Response `200`

Events recorded

- object
  - `inserted` number
  - `success` boolean

## Other responses

- `400` — Invalid meter name or meter is archived
- `404` — One or more customers not found

## Changes

- **2026-07-17** `bbc2ff2bc849` — 2 warning
  - the `events/items/customerRef` request property's maxLength was set to `20`
  - the `events/items/productRef` request property's maxLength was set to `20`
- **2026-07-04** `a30b6aef464d` — 3 info
  - the endpoint scheme security `SecretKey` was added to the API
  - the endpoint scheme security `bearer` was removed from the API
  - added the non-success response with the status `404`
- **2026-04-08** `052cc028fdfa` — 1 breaking, 2 warning
  - added the new required request property `events/items/customerRef`
  - removed the request property `events/items/customerId`
  - removed the request property `events/items/productId`
- **2026-04-07** `d69c95d790d2` — 1 warning, 1 info
  - removed the request property `events/items/productReference`
  - added the new optional request property `events/items/productRef`
- **2026-04-04** `88abf6f50f11` — 3 breaking, 1 info
  - the `events` request property's minItems was increased to `1`
  - the `events/items/customerId` request property's minLength was increased from `0` to `1`
  - the `events/items/meterName` request property's minLength was increased from `0` to `1`
  - the `value` request property default value `1` was removed

[Full history](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/meter-events/bulk/post.md)

---

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