Ireland documents

Driving licence, payslip (PPSN-validated), utility bill, CRO certificate — Irish KYC's real document set.

POST /v1/docs/ie/{type} covers how identity actually works in Ireland — no single national ID card, so KYC runs on photo ID + proof of address + payroll evidence. Extraction plus deterministic validation, including the official PPS-number modulus-23 check character and Eircode format validation. Typically under $0.03 per document.

Endpoint	Document	Key checks
`/v1/docs/ie/driving-licence`	Irish/EU driving licence	licence number, expiry, date coherence, categories
`/v1/docs/ie/payslip`	Payslip	PPSN mod-23 checksum, gross≥net coherence, ≤3-month recency
`/v1/docs/ie/utility-bill`	Utility bill (proof of address)	≤6-month recency, Eircode format, address presence
`/v1/docs/ie/cro-certificate`	CRO certificate of incorporation	company number format, plausible date
`/v1/docs/ie/passport`	Irish passport / passport card	full ICAO 9303 MRZ check-digit set incl. composite, field↔MRZ cross-checks
`/v1/docs/ie/bank-statement`	Bank statement (summary)	IBAN ISO 13616 mod-97, Irish IBAN structure, BIC, period + balance arithmetic
`/v1/docs/ie/employment-detail-summary`	Revenue EDS (P60 successor)	tax-year window, PPSN checksum, per-employment totals cross-sum

curl https://api.gopura.net/v1/docs/ie/payslip \
  -H "Authorization: Bearer $GOPURA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"type": "document_url", "document_url": "data:application/pdf;base64,<PDF>"}}'

{
  "data": {
    "employee_name": "…", "employer_name": "…",
    "ppsn": "1234567FA",
    "pay_date": "2026-08-01",
    "gross_pay": 4200, "net_pay": 3350,
    "paye_tax": 560, "prsi": 168, "usc": 122
  },
  "checks": [
    { "name": "ppsn_checksum_valid", "pass": true, "detail": "official modulus-23 check character" },
    { "name": "amounts_coherent", "pass": true },
    { "name": "recent_within_3_months", "pass": true }
  ]
}

The full KYC triangle

With v2 the pack covers identity, address, and income end to end: passport or licence (identity — the passport's machine-readable zone is validated with the complete ICAO 9303 check-digit set, including the composite, and cross-checked against the printed fields), utility bill (address), and payslip + bank statement + Employment Detail Summary (income and affordability — the bank statement validates the IBAN with the official ISO mod-97 checksum and checks that opening + credits − debits equals the closing balance).

Use cases this set unlocks

Rental/mortgage affordability — payslip extraction with coherence checks feeds income assessment directly (the PRSI/USC lines confirm it's a real Irish payslip structure).
KYC address proof — utility-bill recency is the check every institution applies manually; the Eircode validates structurally.
B2B onboarding — CRO certificate + the authority pointer to core.cro.ie for the authoritative company search.

The PPSN note

PPS numbers are restricted-use under the Social Welfare Acts — only specified bodies may request them. The pack extracts and checksums the PPSN when it appears on a payslip (that's the document's own content), and the authority_hint carries the restriction so relying teams design accordingly. As with every Document Intelligence endpoint: extraction + validation, not identity verification; documents are processed in-flight and never stored.