Submit filing to tax authority connector

POST/payroll/filings/{id}/submit

Transmits a validated filing to the configured statutory authority connector (e.g. GRA for PAYE, SSNIT for social security). The filing transitions to "submitted" status; poll /filings/{id}/status to track authority acknowledgement.

Request

Path parameters

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

Responses

200 Filing transmitted to authority connector

Content type application/json, object.

Field	Type	Required	Description
submission_reference	string	No	Authority-issued submission reference number.
status	string	No	One of: "submitted", "pending_acknowledgement"

Example

{
  "submission_reference": "GRA-PAYE-2026-04-0042",
  "status": "submitted"
}

404 Filing not found

409 Filing has already been submitted or is not in a submittable state

Example request

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