Poll filing status

GET/payroll/filings/{id}/status

Polls the current status of a submitted filing from the authority connector. Use after submission to check whether the authority has acknowledged, accepted, or rejected the filing. Rejection responses include the authority's reason codes.

Request

Path parameters

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

Responses

200 Current filing status from the authority connector

Content type application/json, object · FilingStatusV1.

Field	Type	Required	Description
filing_id	integer	No
status	string	No	One of: "submitted", "pending_acknowledgement", "accepted", "rejected"
submission_reference	string, nullable	No
authority_response	object, nullable	No	Raw response from the authority connector (authority-specific codes and messages).
last_polled_at	string (date-time)	No

Example

{
  "filing_id": 19,
  "status": "accepted",
  "submission_reference": "GRA-PAYE-2026-04-0042",
  "authority_response": {
    "code": "00",
    "message": "Filing accepted and processed."
  },
  "last_polled_at": "2026-04-08T14:30:00Z"
}

404 Filing not found

Example request

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