Skip to content
Constaia
us_permanent_resident_card

US permanent resident card (green card)

Form I-551: USCIS number, category, expiry and machine readable zone.

Category
Residence
Country
United States
Fields it extracts
12 fields
Cost
1 credit
us_permanent_resident_cardspecimen
Document number
USCIS number (A-number)
First name
Last name
Sex
Date of birth
Country of birth
Category
Issue date

Constaia extracts the USCIS number, the category and the dates from the permanent resident card, validates the machine readable zone on the back and checks the expiry date.

  • Constaia does not query USCIS or E-Verify.

What it checks

  • MRZ ICAO 9303. Check digits of the machine readable zone.
  • MRZ vs printed data. The MRZ matches the visible data.
  • National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).us_uscis
  • 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.
  • Form I-9. Whether the document belongs to list A, B or C.A

Fields it extracts

  • Document numberdocument_number
  • USCIS number (A-number)uscis_number
  • First namefirst_name
  • Last namelast_name
  • Sexsex
  • Date of birthbirth_date
  • Country of birthcountry_of_birth
  • Categorycategory
  • Issue dateissue_date
  • Expiry dateexpiry_date
  • Nationalitynationality
  • Mrzmrz

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_green_card_specimen.jpg" \
  -F 'options={
    "expect": "us_permanent_resident_card",
    "checks": {
      "not_expired": true,
      "reference_date": "2026-10-05",
      "holder": {
        "full_name": "Alex Example"
      }
    },
    "storage": "none"
  }'

Try it for free in test mode with the file us_green_card_specimen.jpg.

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_permanent_resident_card",
    "label": "US permanent resident card (green card)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_permanent_resident_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: US permanent resident card (green card)."
      }
    ]
  },
  "fields": {
    "first_name": {
      "value": "ALEX",
      "confidence": 0.99,
      "validated": true
    },
    "last_name": {
      "value": "EXAMPLE",
      "confidence": 0.98,
      "validated": null
    },
    "uscis_number": {
      "value": "000-000-001",
      "confidence": 0.97,
      "validated": null
    },
    "card_number": {
      "value": "SRC0000000001",
      "confidence": 0.96,
      "validated": null
    },
    "category": {
      "value": "IR1",
      "confidence": 0.99,
      "validated": null
    },
    "country_of_birth": {
      "value": "Canada",
      "confidence": 0.98,
      "validated": null
    },
    "birth_date": {
      "value": "1990-01-30",
      "confidence": 0.97,
      "validated": null
    },
    "sex": {
      "value": "F",
      "confidence": 0.96,
      "validated": null
    },
    "resident_since": {
      "value": "2019-08-12",
      "confidence": 0.99,
      "validated": null
    },
    "expiry_date": {
      "value": "2029-08-12",
      "confidence": 0.98,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "mrz_checksums",
      "passed": true,
      "message": "The MRZ check digits are correct."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "The MRZ matches the printed data."
    },
    {
      "code": "not_expired",
      "passed": true,
      "message": "Valid on the reference date."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "The holder matches."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 2
  }
}

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.