Skip to content
Constaia
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
Fields it extracts
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.

Fields it extracts

  • 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 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.