Retrieve the current open period

Request

Purpose

Returns the current open accounting period for a book (and optionally an organization). Handy as the default periodId for new entries.

When to use

Default the posting period of a new entry to the current open period.

Security

OneIdOAuth

Query

bookIdinteger, (int32)required

Accounting book ID.

Example:bookId=1

orgIdstring

Organization ID. Supply it - omitting it currently causes an error.

Example:orgId=101

cURL

curl -i -X GET \
  'https://one.zuora.com/revenue/services/v1/journal-entries/current-period?bookId=1&orgId=101' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Current open period

Headers

traceIdstring

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

Bodyapplication/json

periodIdinteger or null, (int32)

Period ID to use as periodId.

Example:202610

periodDisplayValuestring or null

Period display name.

Example:"OCT-2026"

Response

{
  "periodId": 202610,
  "periodDisplayValue": "OCT-2026"
}