Skip to content
Constaia
ca_photo_id_card

Canadian provincial photo ID card

Photo identification card issued by a province or territory (Ontario Photo Card, BC Services Card…), with an AAMVA PDF417 barcode when present.

Category
Identity
Country
Canada
Fields it extracts
13 fields
Cost
1 credit
ca_photo_id_cardspecimen
Document number
Issuing province
First name
Last name
Date of birth
Issue date
Expiry date
Sex
Height

What it checks

  • PDF417 barcode (AAMVA). The back is decoded and compared with the front.
  • National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).postal_code
  • Postal code. Postal code format of the country.
  • Holder. Name, number or date of birth match what you expect.
  • Age. Minimum or maximum age from the date of birth.
  • Validity. Not expired on the reference date.

Fields it extracts

  • Document numberdocument_number
  • Issuing provinceissuing_province
  • First namefirst_name
  • Last namelast_name
  • Date of birthbirth_date
  • Issue dateissue_date
  • Expiry dateexpiry_date
  • Sexsex
  • Heightheight
  • Addressaddress
  • Postal codepostal_code
  • Dddd
  • Barcode databarcode_data

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "ca_photo_id_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": "ca_photo_id_card",
    "label": "Canadian provincial photo ID card",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "ca_photo_id_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Canadian provincial photo ID card."
      }
    ]
  },
  "fields": {
    "issuing_province": {
      "value": "BC",
      "confidence": 0.99,
      "validated": true
    },
    "document_number": {
      "value": "1234567",
      "confidence": 0.98,
      "validated": null
    },
    "first_name": {
      "value": "JANE",
      "confidence": 0.97,
      "validated": null
    },
    "last_name": {
      "value": "SPECIMEN",
      "confidence": 0.96,
      "validated": null
    },
    "birth_date": {
      "value": "1985-07-30",
      "confidence": 0.99,
      "validated": null
    },
    "issue_date": {
      "value": "2023-07-30",
      "confidence": 0.98,
      "validated": null
    },
    "expiry_date": {
      "value": "2028-07-30",
      "confidence": 0.97,
      "validated": null
    },
    "sex": {
      "value": "F",
      "confidence": 0.96,
      "validated": null
    },
    "address": {
      "value": "501 BELLEVILLE ST, VICTORIA, BC",
      "confidence": 0.99,
      "validated": null
    },
    "postal_code": {
      "value": "V8V 1X4",
      "confidence": 0.98,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "aamva_barcode_matches_front",
      "passed": true,
      "message": "The PDF417 barcode matches the front."
    },
    {
      "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: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is 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 card required.