---
title: "Changes to Record bulk usage events"
method: POST
path: "/v1/sdk/usages/bulk"
---

# Changes to Record bulk usage events

`POST /v1/sdk/usages/bulk`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 27 revisions.

- **2026-07-17** `bbc2ff2bc849` — 3 warning
- **2026-07-04** `a30b6aef464d` — 3 info
- **2026-04-08** `052cc028fdfa` — 1 breaking, 1 warning
- **2026-04-07** `d69c95d790d2` — 2 warning, 2 info
- **2026-04-04** `88abf6f50f11` — 4 breaking, 5 warning, 6 info
- **2026-03-25** `e0583a41987c` — 1 breaking, 3 warning, 7 info
- **2026-03-16** `9fd92a720973` — 2 breaking, 8 warning, 1 info
- **2026-03-16** `c38fce7d1ce2` — 2 breaking, 3 warning, 6 info
- **2026-03-14** `0e1cded2ee5d` — 1 breaking, 2 warning, 2 info
- **2026-02-27** `9079f361f51c` — 1 info

## Changes

- **2026-07-17** `bbc2ff2bc849` — 3 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`
  - the `events/items/purchaseRef` 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 media type `application/json` for the response with the status `200`
- **2026-04-08** `052cc028fdfa` — 1 breaking, 1 warning
  - added the new required request property `events/items/customerRef`
  - removed the request property `events/items/customerId`
- **2026-04-07** `d69c95d790d2` — 2 warning, 2 info
  - removed the request property `events/items/productReference`
  - removed the request property `events/items/purchaseReference`
  - added the new optional request property `events/items/productRef`
  - added the new optional request property `events/items/purchaseRef`
- **2026-04-04** `88abf6f50f11` — 4 breaking, 5 warning, 6 info
  - the request property `events/items/timestamp` became required
  - 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/units` request property type changed from `number` to `integer`
  - the `events/items/units` request property's exclusiveMaximum was set to `false`
  - the `events/items/units` request property's exclusiveMinimum was set to `false`
  - the `events/items/idempotencyKey` request property's maxLength was set to `256`
  - the `events/items/units` request property's max was set to `100000.00`
  - the `events/items/units` request property's min was set to `0.00`
  - added the new optional request property `events/items/description`
  - added the new optional request property `events/items/duration`
  - added the new optional request property `events/items/errorMessage`
  - the `actionType` request property default value `api_call` was added
  - the `outcome` request property default value `success` was added
  - the `units` request property default value `1` was added
- **2026-03-25** `e0583a41987c` — 1 breaking, 3 warning, 7 info
  - added the new required request property `events/items/customerId`
  - removed the request property `events/items/action`
  - removed the request property `events/items/customerRef`
  - removed the request property `events/items/productRef`
  - added the new optional request property `events/items/actionType`
  - added the new optional request property `events/items/idempotencyKey`
  - added the new optional request property `events/items/metadata`
  - added the new optional request property `events/items/outcome`
  - added the new optional request property `events/items/productReference`
  - added the new optional request property `events/items/purchaseReference`
  - added the new optional request property `events/items/timestamp`
- **2026-03-16** `9fd92a720973` — 2 breaking, 8 warning, 1 info
  - added the new required request property `events/items/customerRef`
  - added the new required request property `events/items/productRef`
  - removed the request property `events/items/actionType`
  - removed the request property `events/items/customerId`
  - removed the request property `events/items/idempotencyKey`
  - removed the request property `events/items/metadata`
  - removed the request property `events/items/outcome`
  - removed the request property `events/items/productReference`
  - removed the request property `events/items/purchaseReference`
  - removed the request property `events/items/timestamp`
  - added the new optional request property `events/items/action`
- **2026-03-16** `c38fce7d1ce2` — 2 breaking, 3 warning, 6 info
  - added the new required request property `events/items/customerId`
  - the `events/items/timestamp` request property format changed from no format to `date-time`
  - removed the request property `events/items/customerRef`
  - removed the request property `events/items/meterName`
  - removed the request property `events/items/properties`
  - added the new optional request property `events/items/actionType`
  - added the new optional request property `events/items/idempotencyKey`
  - added the new optional request property `events/items/metadata`
  - added the new optional request property `events/items/outcome`
  - added the new optional request property `events/items/productReference`
  - added the new optional request property `events/items/purchaseReference`
- **2026-03-14** `0e1cded2ee5d` — 1 breaking, 2 warning, 2 info
  - added the new required request property `events/items/meterName`
  - removed the request property `events/items/action`
  - removed the request property `events/items/productRef`
  - added the new optional request property `events/items/properties`
  - added the new optional request property `events/items/timestamp`
- **2026-02-27** `9079f361f51c` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/usages/bulk/post.md) · [API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [Page](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/usages/bulk/post)
