List GL close runs
GET/finance/gl-close-runs
Returns all general-ledger close runs ordered newest-first, together with period locks and reconciliations. Use this to review the history of close activity and current period statuses before initiating a new run.
Request
This endpoint takes no parameters and no request body.
Responses
200 A list of GL close runs with summary counts
Content type application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of object · FinanceGlCloseRunV1 | No | |
data[].id | integer | No | Auto-incremented primary key. |
data[].period | string | No | Accounting period this run covers, in YYYY-MM format. Example: |
data[].status | string | No | Current status of the close run. 'prepared' means checks are done but not yet locked; 'locked' means the period is frozen. One of: |
data[].posted_entries | integer | No | Number of journal entries posted during this close run. Example: |
data[].notes | string, nullable | No | Operator notes recorded at the time the run was created. |
data[].started_by | integer, nullable | No | Tenant user ID of the user who initiated the close run. |
data[].closed_by | integer, nullable | No | Tenant user ID of the user who locked the period. |
data[].closed_at | string (date-time), nullable | No | Timestamp at which the period was locked. |
data[].created_at | string (date-time) | No | Record creation timestamp. |
summary | object · FinanceOpsummaryV1 | No | Aggregate counts for the finance ops dashboard. |
summary.close_runs | integer | No | Total number of GL close run records. |
summary.locked_periods | integer | No | Number of currently locked accounting periods. |
summary.reconciliations | integer | No | Total number of bank reconciliation import records. |
Example
{
"data": [
{
"id": 12,
"period": "2026-03",
"status": "locked",
"posted_entries": 418,
"notes": "Q1 close — reviewed by CFO",
"started_by": 3,
"closed_by": 3,
"closed_at": "2026-04-01T09:15:00Z",
"created_at": "2026-03-31T18:00:00Z"
}
],
"summary": {
"close_runs": 12,
"locked_periods": 3,
"reconciliations": 9
}
}401 Unauthenticated — valid tenant session required
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/finance/gl-close-runs" \
-H "Accept: application/json"