vaccination_certificate

Vaccination certificate

Vaccination certificate or record from any country (including the EU Digital COVID Certificate and the WHO International Certificate of Vaccination, 'yellow card').

Category: Health
Country: International
Extracted fields: 8 fields
Cost: 1 credit

vaccination_certificatespecimen

Holder name
Holder ID number
Date of birth
Certificate id
Issuer
Issue date
Vaccinations
Qr present

What it checks

Holder. Name, number or date of birth match what you expect.

Extracted fields

Holder nameholder_name
Holder ID numberholder_id
Date of birthbirth_date
Certificate idcertificate_id
Issuerissuer
Issue dateissue_date
Vaccinationsvaccinations
Qr presentqr_present

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "vaccination_certificate",
    "checks": {
      "max_age_days": 90,
      "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": "vaccination_certificate",
    "label": "Vaccination certificate",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "vaccination_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Vaccination certificate."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "JUAN ESPAÑOL ESPAÑOL",
      "confidence": 0.99,
      "validated": true
    },
    "birth_date": {
      "value": "1985-07-30",
      "confidence": 0.98,
      "validated": null
    },
    "certificate_id": {
      "value": "URN:UVCI:01:ES:ESPECIMEN0000000001#X",
      "confidence": 0.97,
      "validated": null
    },
    "issuer": {
      "value": "MINISTERIO DE SANIDAD",
      "confidence": 0.96,
      "validated": null
    },
    "issue_date": {
      "value": "2026-03-01",
      "confidence": 0.99,
      "validated": null
    },
    "vaccinations": {
      "value": [
        {
          "disease": "COVID-19",
          "vaccine": "Comirnaty",
          "manufacturer": "BioNTech",
          "dose_number": 3,
          "total_doses": 3,
          "date": "2022-01-10",
          "country": "ESP"
        }
      ],
      "confidence": 0.98,
      "validated": null
    },
    "qr_present": {
      "value": true,
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [],
  "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