Submits a batch of usage transactions captured against a license session.

POST

/api/v1/provision/usage/sessions/{sessionId}/transactions

curl --request POST \
  --url https://example.com/api/v1/provision/usage/sessions/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" } ]'

Requires the license token issued for this session — not a user or service bearer. The token is bound to the session it was issued for, so a bearer that authenticates successfully but was issued for a different session, or for a user, is refused with 403. Send no bearer and the request is 401.

SDK callers get this automatically: the client captures the license token during activation through its authentication provider, so the first upload already carries it.

Parameters

Path Parameters

sessionId

required

string format: uuid

Active license session. Must be the session the bearer token was issued for.

Request Body^required

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

Example^generated

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

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

Example^generated

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

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

Example^generated

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

Responses

200

OK

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

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Forbidden

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}