Skip to main content
POST
/
accounting_new
/
periods
/
validate-close
Validate period close
curl --request POST \
  --url https://api.zenskar.com/accounting_new/periods/validate-close \
  --header 'Content-Type: application/json' \
  --header 'organisation: <api-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "end_date": "2023-12-25"
}
'
{
  "can_close": true,
  "period_start": "2023-12-25",
  "period_end": "2023-12-25",
  "validation_checks": [
    {
      "check_name": "<string>",
      "passed": true,
      "count": 123,
      "message": "<string>",
      "is_blocking": true,
      "details": {}
    }
  ],
  "summary": {}
}

Authorizations

​
x-api-key
string
header
default:<your-api-key>
required
​
organisation
string
header
default:<your-organisation-id>
required

Body

application/json

Request schema for the dry-run that reports what still blocks a close, without actually closing.

​
end_date
string<date>
required

End date to validate for period close

Response

Successful Response

Response schema for period close validation — the checklist of what passed, what failed, and whether the period can actually close.

​
can_close
boolean
required

Whether all blocking validations passed

​
period_start
string<date>
required

Auto-calculated start date

​
period_end
string<date>
required

Requested end date

​
validation_checks
ValidationCheckItemSchema · object[]
required

Detailed results of each validation check

​
summary
Summary · object
required

Aggregate statistics (total_checks, passed, failed, total_issues)