Skip to main content
GET
Get payment file for a pay run

Authorizations

X-Auth-Token
string
header
required

Access token obtained from OAuth2 client credentials flow

X-Org-Id
string
header
required

Organisation to scope the request to. Required when the principal can access more than one organisation; optional for single-organisation principals (the authorizer resolves it automatically).

Path Parameters

payrollConfigId
string
required
year
string
required
frequency
string
required
period
string
required

Response

Payment file retrieved successfully. The body always carries a PaymentFileResponse whose status field is the canonical outcome — GENERATED, PARTIAL_SUCCESS, FAILED, RETRYING, or SUBMITTED. Clients branch on status; do not infer state from HTTP code. file is non-null when a downloadable artefact exists (GENERATED, SUBMITTED, PARTIAL_SUCCESS); failure is non-null when employees were not included (FAILED, PARTIAL_SUCCESS).

message
object
content
object
validationIssues
object[]
messageToken
string