Force-close an accounting period
accounting:close_periodForce-closes an accounting period. The period must pass the close checklist (no unposted JEs, no pending-approval JEs, no open vendor bills, no outstanding AR). Once closed, no new journal entries can be posted with an entry_date in this period (Rule A3).
Year-end close (retained-earnings rollover) is a SEPARATE explicit step:
POST /v1/accounting_periods/{id}/close-fiscal-year. The monthly close does NOT
by itself post a retained-earnings rollover JE.
For the 2-person separation-of-duties workflow, use request-close +
approve-close instead.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Path Parameters
Body
Response
Closed period
An accounting period. Closed periods refuse new journal entry postings (Rule A3). Year-end closing entries that roll revenue and expense activity into retained earnings are posted via a separate explicit endpoint (POST /v1/accounting_periods/{id}/close-fiscal-year). The monthly-period close does NOT by itself post a retained-earnings rollover JE. Verified against live dev RDS accounting.accounting_periods.
Human-readable name (e.g. 'January 2025')
open, close_requested, closed NEW-GAP-REOPEN-PERIOD-ENTITY-ISOLATION-SOD-REASON-AUDIT (2026-05-15): operator-supplied justification from the most recent reopen. 10-500 chars when set. Cleared on next close.
User who most recently reopened this period.

