Skip to main content
POST
Resubmit EPS manually

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

taxYear
integer
required

The tax year to submit EPS for

Required range: 1800 <= x <= 3000
submissionId
string
required

The submission ID to resubmit

Query Parameters

preview
boolean
default:false

Whether to generate a preview without submitting to HMRC

Body

application/json

EPS submission request for tax years 2024-25 and 2025-26

taxYear
integer
required

Tax year (2024 or 2025)

Example:

2025

taxMonth
integer

Tax month

Required range: 1 <= x <= 12
Example:

1

finalSubmissionDetails
object

Final submission details for tax years 2024/2025 and 2025/2026

noPaymentForPeriod
object
periodOfInactivity
object
employmentAllowance
object

Employment allowance with De Minimis State Aid sectors (tax years before 2026-27)

recoverableAmounts
object

Recoverable amounts for tax years 2024-25 and 2025-26

apprenticeshipLevy
object
isPreview
boolean
default:false

Whether this is a preview

Response

EPS submission preview generated successfully

message
object
content
object
validationIssues
object[]
messageToken
string
data
string

The EPS submission XML preview

Example:

"<?xml version=\"1.0\" encoding=\"UTF-8\"?>..."