Skip to content
Constaia
ie_pps_card

Irish Public Services Card

Irish Public Services Card with photo and PPS number (PPSN); not a travel document.

Category
Identity
Country
Ireland
Fields it extracts
5 fields
Cost
1 credit
ie_pps_cardspecimen
Document number
Personal number
First name
Last name
Expiration date

What it checks

  • National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).ie_ppsn
  • Holder. Name, number or date of birth match what you expect.
  • Validity. Not expired on the reference date.

Fields it extracts

  • Document numberdocument_number
  • Personal numberpersonal_number
  • First namefirst_name
  • Last namelast_name
  • Expiration dateexpiry_date

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "ie_pps_card",
    "checks": {
      "not_expired": true,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "ie_pps_card",
    "label": "Irish Public Services Card",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "ie_pps_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Irish Public Services Card."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "123456789",
      "confidence": 0.99,
      "validated": true
    },
    "personal_number": {
      "value": "1234567FA",
      "confidence": 0.98,
      "validated": null
    },
    "first_name": {
      "value": "SEAN",
      "confidence": 0.97,
      "validated": null
    },
    "last_name": {
      "value": "SPECIMEN",
      "confidence": 0.96,
      "validated": null
    },
    "expiry_date": {
      "value": "2031-06-30",
      "confidence": 0.99,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Does Constaia prove that the document is authentic?

No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.

Is a copy of the document kept?

Only if it needs review: then it's kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it's deleted as soon as the analysis ends. You can choose never to keep it.

Other documents

And for the record…

Create your free account and validate your first document in five minutes. No credit card required.