Skip to content
OclavexOclavex Docs

Submits a batch of usage transactions captured against an entitlement (no session context).

POST
/api/v1/provision/usage/entitlements/{entitlementId}/transactions
curl --request POST \
  --url https://example.com/api/v1/provision/usage/entitlements/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/transactions \
  --header 'Content-Type: application/json' \
  --data '[ { "transactionId": 1, "sessionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "apiVersion": 1, "creationDateTime": "2026-04-15T12:00:00Z", "eventName": "example", "eventData": "example" } ]'

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
entitlementId
required
string format: uuid

Target entitlement.

Request Bodyrequired

Section titled “Request Bodyrequired”

Batch of client-side usage records.

Array<object>

One usage event in the SDK’s client-side transaction log, uploaded (online or via the offline transaction-ingest flow) for server-side processing.

object
transactionId

Monotonically increasing id assigned by the local transaction store; the server acknowledges the highest processed id.

integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
sessionId
string format: uuid
apiVersion
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
creationDateTime
string format: date-time
eventName

Type name of the event object serialized into string ClientTransactionRecord.EventData.

string
eventData

The event payload as JSON.

string
Examplegenerated
[
  {
    "transactionId": 1,
    "sessionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "apiVersion": 1,
    "creationDateTime": "2026-04-15T12:00:00Z",
    "eventName": "example",
    "eventData": "example"
  }
]

Responses

Section titled “Responses”

200

Section titled “200”

OK

401

Section titled “401”

Unauthorized

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string