Validate statutory filing payload

POST/payroll/filings/{id}/validate

Runs automated validation checks on a filing's payload against the authority's schema requirements before submission. Returns a validation report with per-field errors. Fix all errors before submitting — authorities typically reject malformed filings with penalties.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the filing to validate.

Responses

200 Filing validation report

Content type application/json, object · FilingValidationResultV1.

Field	Type	Required	Description
filing_id	integer	No
valid	boolean	No	True if all validation checks passed with no errors.
errors	array of object	No	Blocking validation errors that must be fixed before submission.
errors[].field	string	No
errors[].message	string	No
warnings	array of object	No	Non-blocking warnings that may cause authority rejection in some jurisdictions.
warnings[].field	string	No
warnings[].message	string	No

Example

{
  "filing_id": 19,
  "valid": true,
  "errors": [],
  "warnings": [
    {
      "field": "employer_tin",
      "message": "TIN format should be 10 digits without dashes for GRA PAYE submissions."
    }
  ]
}

404 Filing not found

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/filings/{id}/validate" \
  -H "Accept: application/json"