Payslip API (Ireland)

REST API for Irish payslip parsing, verification and Revenue Payroll Notification (RPN) decoding. EUR figures, Revenue 2026 USC bands, PRSI Class A1 4.1 percent rising to 4.2 percent on 1 October 2026.

Base URL

https://api.payslipiq.co.uk

Endpoints

POST/v1/ie/parse

Parse an Irish payslip PDF or image and return structured fields (gross, PAYE, USC, PRSI, pension, AVC, SRCOP, tax credits).

Request and response example

{
  "file": "base64-encoded-payslip.pdf",
  "format": "pdf"
}

{
  "gross": 4500,
  "net": 3120.45,
  "paye": 720,
  "usc": 175.5,
  "prsi": 184.5,
  "pension": 270,
  "avc": 0,
  "prsi_class": "A1",
  "srcop": 44000,
  "tax_credits": 4000,
  "week_month_1": false,
  "currency": "EUR"
}

POST/v1/ie/verify

Verify a structured Irish payslip against Revenue 2026 rules and return anomalies.

Request and response example

{
  "gross": 4500,
  "paye": 720,
  "usc": 175.5,
  "prsi": 184.5,
  "prsi_class": "A1",
  "srcop": 44000,
  "tax_credits": 4000
}

{
  "anomalies": [
    {
      "field": "paye",
      "severity": "warn",
      "message": "PAYE EUR 720 below expected EUR 800 for SRCOP EUR 44,000."
    }
  ],
  "summary": "1 anomaly detected."
}

POST/v1/ie/rpn-decode

Decode a Revenue Payroll Notification payload (cumulative vs Week 1 / Month 1 basis, weekly USC band split, PRSI class).

Request and response example

{
  "ppsn_hash": "sha256:...",
  "rpn_xml": "<rpn>...</rpn>"
}

{
  "basis": "cumulative",
  "annual_tax_credits": 4000,
  "annual_srcop": 44000,
  "prsi_class": "A1",
  "findings": []
}

GET/v1/ie/usc-bands

Return the USC band thresholds for the current tax year.

Request and response example

{
  "band_1": {
    "upTo": 12012,
    "rate": 0.005
  },
  "band_2": {
    "upTo": 27382,
    "rate": 0.02
  },
  "band_3": {
    "upTo": 70044,
    "rate": 0.04
  },
  "band_4": {
    "upTo": null,
    "rate": 0.08
  }
}

Notes

Authentication uses bearer tokens issued from your PaySlipIQ workspace.
PRSI Class letters returned: A1, A2, A8, A9, AX, AL, J, S, M.
USC bands follow Revenue 2026 thresholds: 0.5 percent to EUR 12,012; 2 percent to EUR 27,382; 4 percent to EUR 70,044; 8 percent above.
PRSI Class A1 employee rate steps from 4.1 percent to 4.2 percent on 1 October 2026.
ROS integration is available for enterprise plans for direct RPN retrieval and EDS submission.
All currency values are in EUR. Times are returned in ISO 8601 with Europe/Dublin offset.