Skip to content
Constaia
fr_health_card

French health insurance card (Carte Vitale)

French health insurance card showing the social security registration number (NIR).

Category
Health
Country
France
Extracted fields
5 fields
Cost
1 credit
fr_health_cardspecimen
Social security number
Document number
First name
Last name
Issue date

What it checks

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

Extracted fields

  • Social security numbersocial_security_number
  • Document numberdocument_number
  • First namefirst_name
  • Last namelast_name
  • Issue dateissue_date

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "fr_health_card",
    "checks": {
      "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": "fr_health_card",
    "label": "French health insurance card (Carte Vitale)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "fr_health_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: French health insurance card (Carte Vitale)."
      }
    ]
  },
  "fields": {
    "social_security_number": {
      "value": "1 85 07 75 123 456 08",
      "confidence": 0.99,
      "validated": true
    },
    "document_number": {
      "value": "1234567890",
      "confidence": 0.98,
      "validated": null
    },
    "first_name": {
      "value": "PIERRE",
      "confidence": 0.97,
      "validated": null
    },
    "last_name": {
      "value": "MARTIN",
      "confidence": 0.96,
      "validated": null
    },
    "issue_date": {
      "value": "2022-09-01",
      "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.

Other documents

And for the record…

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