PayslipIQ Public API

Payslip API

Preview of the UK payslip analysis API. v1 launches Q4 2026. Not live: you cannot issue a key today. Waitlist and founding-developer pricing (from £49/month including 10,000 calls) are on the developers page.

Join developer waitlist Endpoint reference

5-line integration

Preview snippets only. v1 is not live. The placeholder is not a key you can issue today.

cURL

curl https://api.payslipiq.co.uk/v1/analyse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gross":3500,"taxCode":"1257L","frequency":"monthly"}'

Node.js

import fetch from 'node-fetch';
const r = await fetch('https://api.payslipiq.co.uk/v1/analyse', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.PSI_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ gross: 3500, taxCode: '1257L', frequency: 'monthly' }),
});

Python

import os, requests
r = requests.post('https://api.payslipiq.co.uk/v1/analyse',
  headers={'Authorization': 'Bearer ' + os.environ['PSI_KEY']},
  json={'gross': 3500, 'taxCode': '1257L', 'frequency': 'monthly'})
print(r.json())

Authentication

v1 is not live. You cannot issue a key today. Planned auth is Authorization: Bearer. Join the waitlist on /developers. There is no dashboard and no checkout. Do not treat the snippets as a live key. Keys are not issued today.

Authorization: Bearer YOUR_API_KEY

Rate limits

Planned waitlist tiers from /developers. Not live. No key issue and no checkout.

Starter

from £49

Waitlist. Q4 2026.

- 10,000 calls per month included
- Waitlist. v1 Q4 2026. Keys are not issued today.

Pro

Waitlist

Waitlist. Q4 2026.

- 100,000 calls per month
- Waitlist. No live checkout.

Enterprise

Custom

Waitlist. Q4 2026.

- Unlimited calls
- Waitlist. Quote only.

Endpoint reference

POST https://api.payslipiq.co.uk/v1/analyse (preview, not live)

Request body

Field	Type	Required	Description
gross	number	yes	Gross pay for the period.
taxCode	string	yes	UK PAYE tax code, for example 1257L or BR.
frequency	enum	yes	"monthly", "weekly" or "fortnightly".
paye	number	no	Income tax already deducted (optional).
ni	number	no	NI already deducted (optional).
pension	number	no	Employee pension this period.
idempotencyKey	string	no	Used to dedupe replayed POSTs.

Response body

Field	Type	Description
expectedNet	number	Net pay implied by 2026/27 PAYE rules.
anomalies	array	Per-rule findings with severity and message.
takeHome	object	Annualised take-home breakdown.
taxCodeMeta	object	Decoded tax code allowance and notes.
requestId	string	Trace identifier for support.

Error codes

Status	Name	Description
400	invalid_request	Body failed schema validation. Check required fields.
401	unauthorised	API key missing or revoked. Send Authorization: Bearer when v1 launches. Keys are not issued today.
402	payment_required	Planned waitlist quota. There is no live upgrade checkout.
403	forbidden	Planned origin allow list. Join the waitlist; there is no live dashboard.
404	not_found	Endpoint or resource id does not exist.
409	duplicate_request	Idempotency key has already been processed.
422	unprocessable	Schema valid but the values are unsupported (e.g. negative gross).
429	rate_limited	Planned waitlist limit. Wait for Retry-After when v1 launches.
500	server_error	PayslipIQ side error. Status page links from /trust.

Ready to integrate?

The public API has not launched yet. v1 is scheduled for Q4 2026. Join the developer waitlist for sandbox access on day one. Waitlist pricing is on /developers (from £49/month including 10,000 calls). There is no live key issue and no checkout.

Join developer waitlist See pricing