Skip to content
Revenue API
/
/
List journal entry audit...

List journal entry audit events

Request

Purpose

Returns the audit trail of a journal entry: who saved, updated, submitted, approved, rejected, recalled or deleted it, when, and with which comment.

When to use

  • Audit and compliance reviews: who created, changed, submitted, approved or rejected an entry, and when.
  • Show the history and approval comments of an entry.
Security
OneIdOAuth
Path
jeIdinteger, (int64)required

ID of the journal entry.

Example:10045
cURL
curl -i -X GET \
  https://one.zuora.com/revenue/services/v1/journal-entries/10045/events \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Audit events (oldest first)

Headers
traceIdstring

Identifier of the request. Quote it when you contact Zuora Support.

Bodyapplication/json
Array [
idinteger or null, (int64)

Audit event ID.

Example:900001
actionstring or null

Action recorded. One of SAVE, UPDATE, SUBMIT, DELETE, APPROVE, REJECT, RECALL.

Example:"SUBMIT"
headerIdinteger or null, (int64)

Identifier of the journal entry (header) this record belongs to.

Example:10045
lineIdinteger or null, (int64)

Line ID when the event concerns a single line.

commentsstring or null

Comment entered with the action.

Example:"Ready for review"
bookIdinteger or null, (int32)

Identifier of the accounting book (for example the primary book or a secondary/parallel book) the entry belongs to.

Example:1
clientIdinteger or null, (int32)

Identifier of your Zuora Revenue client (tenant partition). Informational.

Example:1
createdPeriodIdinteger or null, (int32)

Period ID that was open when the event was recorded.

Example:202609
createdBystring or null

User who performed the action.

Example:"jane.doe@example.com"
createdDatestring or null

When the action was performed.

Example:"2026-09-28 11:02:44"
updatedBystring or null

User who last updated the record.

Example:"jane.doe@example.com"
updatedDatestring or null

Timestamp when the record was last updated (ISO 8601).

Example:"2026-09-28 11:02:44"
secAtrValuestring or null

Organization (security attribute value) of the entry.

Example:"101"
]
Response
[
  {
    "id": 900001,
    "action": "SAVE",
    "headerId": 10045,
    "bookId": 1,
    "clientId": 1,
    "createdPeriodId": 202609,
    "createdBy": "jane.doe@example.com",
    "createdDate": "2026-09-28 10:21:04",
    "secAtrValue": "101"
  },
  {
    "id": 900002,
    "action": "SUBMIT",
    "headerId": 10045,
    "comments": "Ready for September close review",
    "bookId": 1,
    "clientId": 1,
    "createdPeriodId": 202609,
    "createdBy": "jane.doe@example.com",
    "createdDate": "2026-09-28 11:02:44",
    "secAtrValue": "101"
  }
]