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
Extracted fields: 5 fields
Cost: 1 credit

ie_pps_cardspecimen

Document number
Personal number
First name
Last name
Expiry 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.

Extracted fields

Document numberdocument_number
Personal numberpersonal_number
First namefirst_name
Last namelast_name
Expiry 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 the document is authentic?

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

Is a copy of the document kept?

No, unless you ask for it. With storage "none" (the default) the file is deleted when the analysis ends.

And for the record…

Create your account, copy the test key and validate your first document in five minutes.

Create a free account Talk to sales