Registry entry

United States Permanent Resident Card (Green Card) Renewal/Replacement (Form I-90)

Renew or replace a lawful permanent resident's Permanent Resident Card ("Green Card") using Form I-90 (Application to Replace Permanent Resident Card): expired or expiring, lost/stolen/destroyed, never received, mutilated, incorrect due to USCIS error, or after a legal name/biographic change. Distinct from us/uscis/naturalization-n400, which addresses citizenship eligibility, not card renewal for an existing permanent resident. It does not submit the application; the live U.S. Citizenship and Immigration Services (USCIS) source is always authoritative (see VERIFICATION.md).

You are viewing v1.1.0

The latest published version of this schema is v1.2.0 — see the current reference page. Published versions are immutable; this page stays for agents pinned to us/uscis/permanent-resident-card-replacement-i90@1.1.0.

Registry entry

us/uscis/permanent-resident-card-replacement-i90

Jurisdiction
United States · national
Version
1.1.0
Verification
draft
Authority
U.S. Citizenship and Immigration Services

GovSchema spec v0.3

Authoritative source Form I-90 (Edition 01/20/25)

Machine access

Schema document
registry/us/uscis/permanent-resident-card-replacement-i90/1.1.0/schema.jsonapplication/schema+json
Registry catalog
registry/index.jsonone record per schema id

Field reference

98 fields across 7 steps, read from the published schema.json — names, types, requiredness, and validation as the document states them. The live government form remains the authoritative source.

Information about you

  • alienRegistrationNumber string optional

    Personal identifier; handle as sensitive data. Digits only (the form prefixes a printed "A-"); leave blank if none has been assigned.

    pattern
  • uscisOnlineAccountNumber string optional

    Personal identifier; handle as sensitive data.

    length: 0–20
  • currentFamilyName string required

    Personal identifier; handle as sensitive data. The replacement card will be issued in this name.

    length: 1–100
  • currentGivenName string required

    Personal identifier; handle as sensitive data.

    length: 1–100
  • currentMiddleName string optional

    Personal identifier; handle as sensitive data.

    length: 0–100
  • nameLegallyChanged enum required

    If yes, give the name exactly as printed on the existing card (previousFamilyName/previousGivenName/previousMiddleName) and attach evidence of the legal name change. "N/A" applies if the previous card was never received.

    enum: yes | no | not_applicable_never_received_previous_card
  • previousFamilyName string optional

    Personal identifier; handle as sensitive data. Required when nameLegallyChanged is 'yes'. Attach evidence of the legal name change with the application.

    length: 0–100
  • previousGivenName string optional

    Personal identifier; handle as sensitive data. Required when nameLegallyChanged is 'yes'.

    length: 0–100
  • previousMiddleName string optional

    Personal identifier; handle as sensitive data.

    length: 0–100
  • mailingAddressInCareOfName string optional

    If applicable.

    length: 0–100
  • mailingAddressLine1 string required

    Address where USCIS will send correspondence and the replacement card.

    length: 1–120
  • mailingAddressApt string optional

    If applicable.

    length: 0–20
  • mailingAddressCity string required

    City component of the address.

    length: 1–80
  • mailingAddressState string optional

    Required for a U.S. mailing address; leave blank for a foreign address (use mailingAddressProvince instead).

    length: 0–60
  • mailingAddressZipCode string optional

    Required for a U.S. mailing address.

    length: 0–15
  • mailingAddressProvince string optional

    For a foreign mailing address.

    length: 0–60
  • mailingAddressPostalCode string optional

    For a foreign mailing address.

    length: 0–15
  • mailingAddressCountry string required

    Country component of the mailing address.

    length: 1–60
  • physicalAddressDiffersFromMailing boolean optional

    If true, give the physicalAddress* fields. Not itself a numbered form item; inferred from the form's "provide this information only if different than mailing address" instruction.

  • physicalAddressLine1 string optional

    Required when physicalAddressDiffersFromMailing is true.

    length: 0–120
  • physicalAddressApt string optional

    If applicable.

    length: 0–20
  • physicalAddressCity string optional

    Required when physicalAddressDiffersFromMailing is true.

    length: 0–80
  • physicalAddressState string optional

    For a U.S. physical address.

    length: 0–60
  • physicalAddressZipCode string optional

    For a U.S. physical address.

    length: 0–15
  • physicalAddressProvince string optional

    For a foreign physical address.

    length: 0–60
  • physicalAddressPostalCode string optional

    For a foreign physical address.

    length: 0–15
  • physicalAddressCountry string optional

    Required when physicalAddressDiffersFromMailing is true.

    length: 0–60
  • dateOfBirth date required

    Personal identifier; handle as sensitive data. YYYY-MM-DD.

    classification: sensitive-pii
  • placeOfBirthCity string required

    Personal identifier; handle as sensitive data.

    length: 1–80
  • countryOfBirth string required

    Personal identifier; handle as sensitive data.

    length: 1–60
  • mothersGivenName string optional

    Personal identifier; handle as sensitive data.

    length: 0–100
  • fathersGivenName string optional

    Personal identifier; handle as sensitive data.

    length: 0–100
  • classOfAdmission string required

    The immigration classification under which permanent residence was granted (e.g. "IR1", "CR1", "F2A").

    length: 1–20
  • dateOfAdmission date required

    YYYY-MM-DD. The date permanent resident status was granted or admission occurred.

  • socialSecurityNumber string optional

    Personal identifier; handle as sensitive data.

    patternclassification: sensitive-pii
  • sex enum required

    Personal identifier; handle as sensitive data.

    enum: male | female

Application type and reason

  • permanentResidentStatus enum required

    Lawful permanent resident and permanent resident (commuter status) both proceed to Section A reasons (reasonForApplicationSectionA); conditional permanent resident proceeds to Section B reasons (reasonForApplicationSectionB).

    enum: lawful_permanent_resident | permanent_resident_commuter_status | conditional_permanent_resident
  • reasonForApplicationSectionA enum optional

    Required when permanentResidentStatus is 'lawful_permanent_resident' or 'permanent_resident_commuter_status'. Select only one. When the reason is entering/leaving commuter status (the two 'h' options), also give portOfEntry.

    enum: 12 values
  • reasonForApplicationSectionB enum optional

    Required when permanentResidentStatus is 'conditional_permanent_resident'. Select only one. Do not file if conditional status expires within the next 90 days.

    enum: lost_stolen_or_destroyed | issued_but_never_received | mutilated | incorrect_data_dhs_error | name_or_biographic_info_legally_changed
  • portOfEntry string optional

    Required when reasonForApplicationSectionA is 'taking_up_commuter_status'.

    length: 0–100

Processing information and biographic details

  • locationAppliedForImmigrantVisaOrAdjustment string required

    City/town and state, or foreign post.

    length: 1–100
  • locationVisaIssuedOrAdjustmentGranted string required

    City/town and state, foreign post, or USCIS field office name.

    length: 1–100
  • enteredWithImmigrantVisa boolean required

    If true, give destinationAtAdmission and portOfEntryAtAdmission. If false (i.e. status was via adjustment of status), those are not applicable. Inferred from the form's routing instruction rather than a separately numbered yes/no item.

  • destinationAtAdmission string optional

    Required when enteredWithImmigrantVisa is true.

    length: 0–100
  • portOfEntryAtAdmission string optional

    Required when enteredWithImmigrantVisa is true.

    length: 0–100
  • everInRemovalProceedings boolean required

    If true, provide a detailed explanation using additionalInformationEntries.

  • everFiledI407OrAbandonedStatus boolean required

    If true, provide a detailed explanation using additionalInformationEntries.

  • heightFeet integer required

    The extracted PDF text interleaves the Height/Weight item numbers (6-9) with the surrounding Section B reason checkboxes, so the exact item-number-to-field mapping is not fully unambiguous from text extraction alone; see VERIFICATION.md.

    range: 0–8
  • heightInches integer required

    See heightFeet for the item-number caveat.

    range: 0–11
  • weightPounds integer required

    See heightFeet for the item-number caveat.

    range: 1–999
  • ethnicity enum required

    Select only one box.

    enum: hispanic_or_latino | not_hispanic_or_latino
  • race string required

    Select all applicable boxes. Modeled as a comma-separated list of: american_indian_or_alaska_native, asian, black_or_african_american, native_hawaiian_or_other_pacific_islander, white.

    length: 1–200
  • eyeColor enum required

    Select only one box.

    enum: 9 values
  • hairColor enum required

    Select only one box.

    enum: 9 values

Accommodations for individuals with disabilities and/or impairments

  • requestingDisabilityAccommodation boolean required

    If true, select at least one of deafOrHardOfHearingAccommodation, blindOrLowVisionAccommodation, or otherDisabilityAccommodation.

  • deafOrHardOfHearingAccommodation string optional

    Personal identifier; handle as sensitive data. E.g. a requested sign-language interpreter and which language.

    length: 0–500
  • blindOrLowVisionAccommodation string optional

    Personal identifier; handle as sensitive data.

    length: 0–500
  • otherDisabilityAccommodation string optional

    Personal identifier; handle as sensitive data.

    length: 0–500

Applicant's statement, contact information, certification, and signature

  • applicantCanReadEnglish boolean required

    Select the box for either this or usedInterpreter (mutually exclusive). If neither applies literally, the form still requires selecting one.

  • usedInterpreter boolean required

    Mutually exclusive with applicantCanReadEnglish. If true, complete the interpreter* fields and give interpreterLanguage.

  • interpreterLanguage string optional

    Required when usedInterpreter is true.

    length: 0–60
  • usedPreparer boolean optional

    If true, complete the preparer* fields.

  • applicantDaytimePhoneNumber string required

    Personal identifier; handle as sensitive data. In international E.164 format.

    pattern
  • applicantMobilePhoneNumber string optional

    Personal identifier; handle as sensitive data. In international E.164 format.

    pattern
  • applicantEmail string optional

    Personal identifier; handle as sensitive data.

    length: 0–160
  • applicantSignatureDate date required

    YYYY-MM-DD. By signing, the applicant certifies under penalty of perjury that all information provided is complete, true, and correct, and acknowledges the required biometrics appointment.

Interpreter's contact information, certification, and signature

  • interpreterFamilyName string optional

    Personal identifier; handle as sensitive data. Required when usedInterpreter is true.

    length: 0–100
  • interpreterGivenName string optional

    Personal identifier; handle as sensitive data. Required when usedInterpreter is true.

    length: 0–100
  • interpreterBusinessOrOrganizationName string optional

    If applicable.

    length: 0–160
  • interpreterAddressLine1 string optional

    Personal identifier; handle as sensitive data. Required when usedInterpreter is true.

    length: 0–120
  • interpreterAddressApt string optional

    If applicable.

    length: 0–20
  • interpreterAddressCity string optional

    Personal identifier; handle as sensitive data. Required when usedInterpreter is true.

    length: 0–80
  • interpreterAddressState string optional

    Required for a U.S. mailing address; leave blank for a foreign address (use interpreterAddressProvince instead).

    length: 0–60
  • interpreterAddressZipCode string optional

    Required for a U.S. mailing address.

    length: 0–15
  • interpreterAddressProvince string optional

    For a foreign mailing address.

    length: 0–60
  • interpreterAddressPostalCode string optional

    For a foreign mailing address.

    length: 0–15
  • interpreterAddressCountry string optional

    Personal identifier; handle as sensitive data. Required when usedInterpreter is true.

    length: 0–60
  • interpreterDaytimePhoneNumber string optional

    Personal identifier; handle as sensitive data. Required when usedInterpreter is true. In international E.164 format.

    pattern
  • interpreterMobilePhoneNumber string optional

    Personal identifier; handle as sensitive data. In international E.164 format.

    pattern
  • interpreterEmail string optional

    Personal identifier; handle as sensitive data.

    length: 0–160
  • interpreterSignatureDate date optional

    YYYY-MM-DD. Required when usedInterpreter is true.

Preparer's contact information, declaration, and signature

  • preparerFamilyName string optional

    Personal identifier; handle as sensitive data. Required when usedPreparer is true.

    length: 0–100
  • preparerGivenName string optional

    Personal identifier; handle as sensitive data. Required when usedPreparer is true.

    length: 0–100
  • preparerBusinessOrOrganizationName string optional

    If applicable.

    length: 0–160
  • preparerAddressLine1 string optional

    Personal identifier; handle as sensitive data. Required when usedPreparer is true.

    length: 0–120
  • preparerAddressApt string optional

    If applicable.

    length: 0–20
  • preparerAddressCity string optional

    Personal identifier; handle as sensitive data. Required when usedPreparer is true.

    length: 0–80
  • preparerAddressState string optional

    Required for a U.S. mailing address; leave blank for a foreign address (use preparerAddressProvince instead).

    length: 0–60
  • preparerAddressZipCode string optional

    Required for a U.S. mailing address.

    length: 0–15
  • preparerAddressProvince string optional

    For a foreign mailing address.

    length: 0–60
  • preparerAddressPostalCode string optional

    For a foreign mailing address.

    length: 0–15
  • preparerAddressCountry string optional

    Personal identifier; handle as sensitive data. Required when usedPreparer is true.

    length: 0–60
  • preparerDaytimePhoneNumber string optional

    Personal identifier; handle as sensitive data. Required when usedPreparer is true. In international E.164 format.

    pattern
  • preparerMobilePhoneNumber string optional

    Personal identifier; handle as sensitive data. In international E.164 format.

    pattern
  • preparerEmail string optional

    Personal identifier; handle as sensitive data.

    length: 0–160
  • preparerIsAttorneyOrAccreditedRepresentative boolean optional

    Required when usedPreparer is true. If true, also give preparerRepresentationExtendsBeyondPreparation; if the representation extends beyond preparing this application, Form G-28 may also be required (out of scope here).

  • preparerRepresentationExtendsBeyondPreparation boolean optional

    Required when preparerIsAttorneyOrAccreditedRepresentative is true.

  • preparerSignatureDate date optional

    YYYY-MM-DD. Required when usedPreparer is true.

Version history

Independent and non-affiliated

GovSchema is an independent, open-source project. This reference is not produced, reviewed, or endorsed by U.S. Citizenship and Immigration Services or any government. The authoritative source is always the live government form and its official instructions.