Usage

Record bulk usage events

Same persistence rules as POST /sdk/usages for each item: validate batch first, then one insert per event.

post/v1/sdk/usages/bulk

Request body

Response

Bulk usage events processed

insertednumber required

Number of usage events inserted

successboolean required

Example response

{
  "inserted": 2,
  "results": [
    {
      "creditDebit": {
        "amount": 100,
        "autoRecharge": {
          "triggered": true
        },
        "unitsRemaining": 99
      },
      "reference": "usage_A1B2C3D4"
    }
  ],
  "success": true
}

Changes

Changed in 10 of the 27 revisions of this API.112728

Jul 17, 2026bbc2ff2bc8493See the full diff
- ●
  the // request property's maxLength was set to 20
  request-property-max-length-set
- ●
  the // request property's maxLength was set to 20
  request-property-max-length-set
- ●
  the // request property's maxLength was set to 20
  request-property-max-length-set
Jul 4, 2026a30b6aef464d3See the full diff
- ○
  the endpoint scheme security SecretKey was added to the API
  api-security-added
- ○
  the endpoint scheme security bearer was removed from the API
  api-security-removed
- ○
  added the media type application/json for the response with the status
  response-media-type-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 8, 2026052cc028fdfa11See the full diff
- ▲
  added the new required request property //
  new-required-request-property
- ●
  removed the request property //
  request-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 7, 2026d69c95d790d222See the full diff
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
Apr 4, 202688abf6f50f11456See the full diff
- ▲
  the request property // became required
  request-property-became-required
- ▲
  the request property's minItems was increased to 1
  request-property-min-items-increased
- ▲
  the // request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the // request property type changed from number to integer
  request-property-type-changed
- ●
  the // request property's exclusiveMaximum was set to false
  request-property-exclusive-max-set
- ●
  the // request property's exclusiveMinimum was set to false
  request-property-exclusive-min-set
- ●
  the // request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the // request property's max was set to 100000.00
  request-property-max-set
- ●
  the // request property's min was set to 0.00
  request-property-min-set
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  the request property default value api_call was added
  request-property-default-value-added
- ○
  the request property default value success was added
  request-property-default-value-added
- ○
  the request property default value 1 was added
  request-property-default-value-added
This revision also has 44 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 25, 2026e0583a41987c137See the full diff
- ▲
  added the new required request property //
  new-required-request-property
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 16, 20269fd92a720973281See the full diff
- ▲
  added the new required request property //
  new-required-request-property
- ▲
  added the new required request property //
  new-required-request-property
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 16, 2026c38fce7d1ce2236See the full diff
- ▲
  added the new required request property //
  new-required-request-property
- ▲
  the // request property format changed from no format to date-time
  request-property-type-changed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 14, 20260e1cded2ee5d122See the full diff
- ▲
  added the new required request property //
  new-required-request-property
- ●
  removed the request property //
  request-property-removed
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 27, 20269079f361f51c1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history