Registry entry

United States Petition for Alien Relative (Form I-130)

A U.S. citizen, lawful permanent resident, or non-citizen U.S. national (the petitioner) establishes a qualifying family relationship with an alien relative (the beneficiary) who wishes to immigrate to the United States, using Form I-130 (Petition for Alien Relative). Approval does not itself confer immigration status; the beneficiary separately applies for a Green Card via Form I-485 (adjustment of status, us/uscis/adjustment-of-status-i485, when available in the registry) or through consular processing with the U.S. Department of State. Distinct from us/uscis/permanent-resident-card-replacement-i90 (Green Card renewal for an existing permanent resident, not a new relationship petition). It does not submit the petition; the live U.S. Citizenship and Immigration Services (USCIS) source is always authoritative (see VERIFICATION.md).

Registry entry

us/uscis/petition-alien-relative-i130

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

GovSchema spec v0.3

Authoritative source Form I-130 (Edition 04/01/24)

Machine access

Schema document
registry/us/uscis/petition-alien-relative-i130/1.0.0/schema.jsonapplication/schema+json
Verification record
registry/us/uscis/petition-alien-relative-i130/1.0.0/VERIFICATION.mdtext/markdown
Registry catalog
registry/index.jsonone record per schema id

Field reference

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

Relationship to the beneficiary

  • relationshipToBeneficiary enum required

    Select only one box. Determines the visa classification this petition establishes eligibility for.

    enum: spouse | parent | sibling | child
  • childOrParentRelationshipType enum optional

    Select the box that describes the relationship. Required when relationshipToBeneficiary is parent or child.

    enum: born_in_wedlock | born_out_of_wedlock | adopted_child | stepchild_or_stepparent
  • petitionerGainedStatusThroughAdoption boolean required

    Relevant to the "who may not file" restriction on natural parents who themselves gained status through adoption.

  • beneficiarySiblingRelatedByAdoption boolean optional

    Required when relationshipToBeneficiary is sibling.

Information about the petitioner

  • petitionerGainedStatusThroughAdoption boolean required

    Relevant to the "who may not file" restriction on natural parents who themselves gained status through adoption.

  • petitionerAlienRegistrationNumber string optional

    Personal identifier; handle as sensitive data. Digits only (the form prefixes a printed "A-").

    patternclassification: sensitive-pii
  • petitionerUscisOnlineAccountNumber string optional

    Personal identifier; handle as sensitive data.

    length: 0–20
  • petitionerSsn string optional

    Personal identifier; handle as sensitive data.

    patternclassification: sensitive-pii
  • petitionerFamilyName string required

    Personal identifier; handle as sensitive data.

    length: 1–100
  • petitionerGivenName string required

    Personal identifier; handle as sensitive data.

    length: 1–100
  • petitionerMiddleName string optional

    Personal identifier; handle as sensitive data.

    length: 0–100
  • petitionerOtherNamesFamilyName string optional

    Include aliases, maiden name, and nicknames, if any.

    length: 0–100
  • petitionerOtherNamesGivenName string optional

    Petitioner's other names used — given name

    length: 0–100
  • petitionerOtherNamesMiddleName string optional

    Petitioner's other names used — middle name

    length: 0–100
  • petitionerCityOfBirth string required

    Petitioner's city/town/village of birth

    length: 1–100
  • petitionerCountryOfBirth string required

    Petitioner's country of birth

    length: 1–60
  • petitionerDateOfBirth date required

    Petitioner's date of birth

  • petitionerSex enum required

    Petitioner's sex

    enum: male | female
  • petitionerMailingAddressInCareOfName string optional

    If applicable.

    length: 0–100
  • petitionerMailingAddressLine1 string required

    Street number and name.

    length: 1–120
  • petitionerMailingAddressApt string optional

    If applicable.

    length: 0–20
  • petitionerMailingAddressCity string required

    City or town component of the address.

    length: 1–80
  • petitionerMailingAddressState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • petitionerMailingAddressZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • petitionerMailingAddressProvince string optional

    For a foreign address.

    length: 0–60
  • petitionerMailingAddressPostalCode string optional

    For a foreign address.

    length: 0–15
  • petitionerMailingAddressCountry string required

    Country component of the address.

    length: 1–60
  • petitionerMailingSameAsPhysical boolean required

    Is the petitioner's current mailing address the same as their physical address?

  • petitionerPhysicalAddressLine1 string optional

    Street number and name.

    length: 1–120
  • petitionerPhysicalAddressApt string optional

    If applicable.

    length: 0–20
  • petitionerPhysicalAddressCity string optional

    City or town component of the address.

    length: 0–80
  • petitionerPhysicalAddressState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • petitionerPhysicalAddressZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • petitionerPhysicalAddressProvince string optional

    For a foreign address.

    length: 0–60
  • petitionerPhysicalAddressPostalCode string optional

    For a foreign address.

    length: 0–15
  • petitionerPhysicalAddressCountry string optional

    Country component of the address.

    length: 0–60
  • petitionerNumberOfMarriages integer optional

    How many times has the petitioner been married?

    range: 0–20
  • petitionerCurrentMaritalStatus enum required

    Petitioner's current marital status

    enum: single_never_married | married | divorced | widowed | separated | annulled
  • petitionerDateOfCurrentMarriage date optional

    Date of petitioner's current marriage (if currently married)

  • petitionerCurrentMarriagePlaceCity string optional

    Place of petitioner's current marriage — city or town

    length: 0–80
  • petitionerCurrentMarriagePlaceState string optional

    Place of petitioner's current marriage — state

    length: 0–60
  • petitionerCurrentMarriagePlaceProvince string optional

    Place of petitioner's current marriage — province

    length: 0–60
  • petitionerCurrentMarriagePlaceCountry string optional

    Place of petitioner's current marriage — country

    length: 0–60
  • petitionerSpouse1FamilyName string optional

    Simplification: this schema models the petitioner's current/most recent spouse only. USCIS Form I-130 provides two prior-spouse slots ("Spouse 1"/"Spouse 2"); see VERIFICATION.md.

    length: 0–100
  • petitionerSpouse1GivenName string optional

    Petitioner's spouse (current or most recent) — given name

    length: 0–100
  • petitionerSpouse1MiddleName string optional

    Petitioner's spouse (current or most recent) — middle name

    length: 0–100
  • petitionerSpouse1MarriageEndedDate date optional

    Date that marriage to this spouse ended (if applicable)

  • petitionerParent1FamilyName string optional

    Petitioner's Parent 1 — family name

    length: 0–100
  • petitionerParent1GivenName string optional

    Petitioner's Parent 1 — given name

    length: 0–100
  • petitionerParent1MiddleName string optional

    Petitioner's Parent 1 — middle name

    length: 0–100
  • petitionerParent1DateOfBirth date optional

    Petitioner's Parent 1 — date of birth

  • petitionerParent1CountryOfBirth string optional

    Petitioner's Parent 1 — country of birth

    length: 0–60
  • petitionerParent2FamilyName string optional

    Petitioner's Parent 2 — family name

    length: 0–100
  • petitionerParent2GivenName string optional

    Petitioner's Parent 2 — given name

    length: 0–100
  • petitionerParent2MiddleName string optional

    Petitioner's Parent 2 — middle name

    length: 0–100
  • petitionerParent2DateOfBirth date optional

    Petitioner's Parent 2 — date of birth

  • petitionerParent2CountryOfBirth string optional

    Petitioner's Parent 2 — country of birth

    length: 0–60
  • petitionerCitizenshipBasis enum required

    Petitioner is a

    enum: us_citizen | lawful_permanent_resident
  • petitionerCitizenshipAcquiredThrough enum optional

    Petitioner's citizenship was acquired through

    enum: birth_in_us | naturalization | parents
  • petitionerHasCertificateOfNaturalizationOrCitizenship boolean optional

    Has the petitioner obtained a Certificate of Naturalization or a Certificate of Citizenship?

  • petitionerCertificateNumber string optional

    Certificate number

    length: 0–30
  • petitionerCertificatePlaceOfIssuance string optional

    Certificate — place of issuance

    length: 0–100
  • petitionerCertificateDateOfIssuance date optional

    Certificate — date of issuance

  • petitionerClassOfAdmission string optional

    Petitioner's class of admission (if a lawful permanent resident)

    length: 0–20
  • petitionerDateOfAdmission date optional

    Petitioner's date of admission as a lawful permanent resident

  • petitionerPlaceOfAdmissionCity string optional

    Petitioner's place of admission — city or town

    length: 0–80
  • petitionerPlaceOfAdmissionState string optional

    Petitioner's place of admission — state

    length: 0–60
  • petitionerGainedLprThroughMarriage boolean optional

    Did the petitioner gain lawful permanent resident status through marriage to a U.S. citizen or lawful permanent resident?

  • petitionerEthnicity enum required

    Select only one box.

    enum: hispanic_or_latino | not_hispanic_or_latino
  • petitionerRace 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
  • petitionerHeightFeet integer required

    Petitioner's height — feet

    range: 0–8
  • petitionerHeightInches integer required

    Petitioner's height — inches

    range: 0–11
  • petitionerWeightPounds integer required

    Petitioner's weight — pounds

    range: 1–999
  • petitionerEyeColor enum required

    Petitioner's eye color

    enum: 9 values
  • petitionerHairColor enum required

    Petitioner's hair color

    enum: 9 values

Petitioner's biographic information

  • petitionerEthnicity enum required

    Select only one box.

    enum: hispanic_or_latino | not_hispanic_or_latino
  • petitionerRace 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
  • petitionerHeightFeet integer required

    Petitioner's height — feet

    range: 0–8
  • petitionerHeightInches integer required

    Petitioner's height — inches

    range: 0–11
  • petitionerWeightPounds integer required

    Petitioner's weight — pounds

    range: 1–999
  • petitionerEyeColor enum required

    Petitioner's eye color

    enum: 9 values
  • petitionerHairColor enum required

    Petitioner's hair color

    enum: 9 values

Information about the beneficiary

  • beneficiarySiblingRelatedByAdoption boolean optional

    Required when relationshipToBeneficiary is sibling.

  • beneficiaryAlienRegistrationNumber string optional

    Personal identifier; handle as sensitive data.

    patternclassification: sensitive-pii
  • beneficiaryUscisOnlineAccountNumber string optional

    Beneficiary's USCIS Online Account Number, if any

    length: 0–20
  • beneficiarySsn string optional

    Personal identifier; handle as sensitive data.

    patternclassification: sensitive-pii
  • beneficiaryFamilyName string required

    Personal identifier; handle as sensitive data.

    length: 1–100
  • beneficiaryGivenName string required

    Personal identifier; handle as sensitive data.

    length: 1–100
  • beneficiaryMiddleName string optional

    Beneficiary's full name — middle name

    length: 0–100
  • beneficiaryOtherNamesFamilyName string optional

    Include aliases, maiden name, and nicknames, if any.

    length: 0–100
  • beneficiaryOtherNamesGivenName string optional

    Beneficiary's other names used — given name

    length: 0–100
  • beneficiaryOtherNamesMiddleName string optional

    Beneficiary's other names used — middle name

    length: 0–100
  • beneficiaryCityOfBirth string required

    Beneficiary's city/town/village of birth

    length: 1–100
  • beneficiaryCountryOfBirth string required

    Beneficiary's country of birth

    length: 1–60
  • beneficiaryDateOfBirth date required

    Beneficiary's date of birth

  • beneficiarySex enum required

    Beneficiary's sex

    enum: male | female
  • beneficiaryEverFiledForByOthers enum required

    Select "unknown" only if neither the petitioner nor the beneficiary knows.

    enum: yes | no | unknown
  • beneficiaryPhysicalAddressLine1 string required

    Street number and name.

    length: 1–120
  • beneficiaryPhysicalAddressApt string optional

    If applicable.

    length: 0–20
  • beneficiaryPhysicalAddressCity string required

    City or town component of the address.

    length: 1–80
  • beneficiaryPhysicalAddressState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • beneficiaryPhysicalAddressZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • beneficiaryPhysicalAddressProvince string optional

    For a foreign address.

    length: 0–60
  • beneficiaryPhysicalAddressPostalCode string optional

    For a foreign address.

    length: 0–15
  • beneficiaryPhysicalAddressCountry string required

    Country component of the address.

    length: 1–60
  • beneficiaryDaytimePhoneNumber string optional

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

    pattern
  • beneficiaryMobilePhoneNumber string optional

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

    pattern
  • beneficiaryEmail string optional

    Personal identifier; handle as sensitive data.

    length: 0–160
  • beneficiaryNumberOfMarriages integer optional

    How many times has the beneficiary been married?

    range: 0–20
  • beneficiaryCurrentMaritalStatus enum required

    Beneficiary's current marital status

    enum: single_never_married | married | divorced | widowed | separated | annulled
  • beneficiaryDateOfCurrentMarriage date optional

    Date of beneficiary's current marriage (if currently married)

  • beneficiaryCurrentMarriagePlaceCity string optional

    Place of beneficiary's current marriage — city or town

    length: 0–80
  • beneficiaryCurrentMarriagePlaceCountry string optional

    Place of beneficiary's current marriage — country

    length: 0–60
  • beneficiarySpouse1FamilyName string optional

    Simplification: this schema models the beneficiary's current/most recent spouse only. USCIS Form I-130 provides two prior-spouse slots; see VERIFICATION.md.

    length: 0–100
  • beneficiarySpouse1GivenName string optional

    Beneficiary's spouse (current or most recent) — given name

    length: 0–100
  • beneficiarySpouse1MiddleName string optional

    Beneficiary's spouse (current or most recent) — middle name

    length: 0–100
  • beneficiarySpouse1MarriageEndedDate date optional

    Date that marriage to this spouse ended (if applicable)

  • beneficiaryFamilyPerson1FamilyName string optional

    Simplification: this schema models the first of the form's five "Information About Beneficiary's Family" person slots (typically the beneficiary's spouse or eldest accompanying child); see VERIFICATION.md.

    length: 0–100
  • beneficiaryFamilyPerson1GivenName string optional

    Beneficiary's family — Person 1 — given name

    length: 0–100
  • beneficiaryFamilyPerson1MiddleName string optional

    Beneficiary's family — Person 1 — middle name

    length: 0–100
  • beneficiaryFamilyPerson1Relationship string optional

    Beneficiary's family — Person 1 — relationship to beneficiary

    length: 0–60
  • beneficiaryFamilyPerson1DateOfBirth date optional

    Beneficiary's family — Person 1 — date of birth

  • beneficiaryFamilyPerson1CountryOfBirth string optional

    Beneficiary's family — Person 1 — country of birth

    length: 0–60
  • beneficiaryEverInUs boolean required

    Was the beneficiary EVER in the United States?

  • beneficiaryClassOfAdmission string optional

    Beneficiary's class of admission on last arrival

    length: 0–20
  • beneficiaryI94Number string optional

    Beneficiary's Form I-94 Arrival-Departure Record number

    length: 0–20
  • beneficiaryDateOfArrival date optional

    Beneficiary's date of last arrival

  • beneficiaryAuthorizedStayExpirationDate string optional

    mm/dd/yyyy, or literally "D/S" for Duration of Status.

    length: 0–10
  • beneficiaryPassportNumber string optional

    Beneficiary's passport number

    length: 0–30
  • beneficiaryTravelDocumentNumber string optional

    Beneficiary's travel document number

    length: 0–30
  • beneficiaryPassportCountryOfIssuance string optional

    Country of issuance for beneficiary's passport or travel document

    length: 0–60
  • beneficiaryPassportExpirationDate date optional

    Expiration date for beneficiary's passport or travel document

  • beneficiaryEverInImmigrationProceedings boolean required

    Was the beneficiary EVER in immigration proceedings?

  • beneficiaryImmigrationProceedingsType enum optional

    Type of immigration proceedings

    enum: removal | exclusion_or_deportation | rescission | other_judicial_proceedings
  • beneficiaryImmigrationProceedingsCity string optional

    Immigration proceedings — city or town

    length: 0–80
  • beneficiaryImmigrationProceedingsState string optional

    Immigration proceedings — state

    length: 0–60
  • beneficiaryImmigrationProceedingsDate date optional

    Immigration proceedings — date

  • beneficiaryNativeLanguageFamilyName string optional

    Beneficiary's name in native written language (if it does not use Roman letters) — family name

    length: 0–100
  • beneficiaryNativeLanguageGivenName string optional

    Beneficiary's name in native written language — given name

    length: 0–100
  • beneficiaryNativeLanguageMiddleName string optional

    Beneficiary's name in native written language — middle name

    length: 0–100
  • beneficiaryNativeLanguageAddressLine1 string optional

    Street number and name.

    length: 1–120
  • beneficiaryNativeLanguageAddressApt string optional

    If applicable.

    length: 0–20
  • beneficiaryNativeLanguageAddressCity string optional

    City or town component of the address.

    length: 0–80
  • beneficiaryNativeLanguageAddressState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • beneficiaryNativeLanguageAddressZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • beneficiaryNativeLanguageAddressProvince string optional

    For a foreign address.

    length: 0–60
  • beneficiaryNativeLanguageAddressPostalCode string optional

    For a foreign address.

    length: 0–15
  • beneficiaryNativeLanguageAddressCountry string optional

    Country component of the address.

    length: 0–60
  • beneficiaryLastAddressTogetherLine1 string optional

    Street number and name.

    length: 1–120
  • beneficiaryLastAddressTogetherApt string optional

    If applicable.

    length: 0–20
  • beneficiaryLastAddressTogetherCity string optional

    City or town component of the address.

    length: 0–80
  • beneficiaryLastAddressTogetherState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • beneficiaryLastAddressTogetherZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • beneficiaryLastAddressTogetherProvince string optional

    For a foreign address.

    length: 0–60
  • beneficiaryLastAddressTogetherPostalCode string optional

    For a foreign address.

    length: 0–15
  • beneficiaryLastAddressTogetherCountry string optional

    Country component of the address.

    length: 0–60
  • beneficiaryLastAddressTogetherDateFrom date optional

    Lived together — date from

  • beneficiaryLastAddressTogetherDateTo string optional

    mm/dd/yyyy, or "PRESENT" if still living together.

    length: 0–10
  • beneficiaryApplicationType enum required

    Select only one option — the form instructs petitioners not to complete both item 61 and item 62.

    enum: adjustment_of_status | consular_processing
  • beneficiaryAdjustmentOfStatusUscisOfficeCity string optional

    USCIS office where the beneficiary will apply for adjustment of status — city or town

    length: 0–80
  • beneficiaryAdjustmentOfStatusUscisOfficeState string optional

    USCIS office where the beneficiary will apply for adjustment of status — state

    length: 0–60
  • beneficiaryConsularPostCity string optional

    U.S. Embassy or Consulate where the beneficiary will apply for an immigrant visa — city or town

    length: 0–80
  • beneficiaryConsularPostCountry string optional

    U.S. Embassy or Consulate where the beneficiary will apply for an immigrant visa — country

    length: 0–60
  • beneficiaryConsularPostProvince string optional

    U.S. Embassy or Consulate where the beneficiary will apply for an immigrant visa — province

    length: 0–60

Other information

  • petitionerEverFiledPetitionForBeneficiaryOrOtherAlien boolean required

    Have you EVER previously filed a petition for this beneficiary or any other alien?

  • priorPetitionBeneficiaryFamilyName string optional

    Prior petition — beneficiary family name

    length: 0–100
  • priorPetitionBeneficiaryGivenName string optional

    Prior petition — beneficiary given name

    length: 0–100
  • priorPetitionBeneficiaryMiddleName string optional

    Prior petition — beneficiary middle name

    length: 0–100
  • priorPetitionDateFiled date optional

    Prior petition — date filed

  • priorPetitionResult string optional

    Prior petition — result (for example, approved, denied, withdrawn)

    length: 0–60
  • relative1FamilyName string optional

    Simplification: this schema models one additional relative slot; the form provides a second ("Relative 2"); see VERIFICATION.md.

    length: 0–100
  • relative1GivenName string optional

    Other relative — given name

    length: 0–100
  • relative1MiddleName string optional

    Other relative — middle name

    length: 0–100
  • relative1Relationship string optional

    Other relative — relationship to petitioner

    length: 0–60

Petitioner's statement, contact information, and signature

  • petitionerCanReadEnglish boolean required

    Select the box for either this item or petitionerUsedInterpreter, per the form's Part 6 instructions.

  • petitionerUsedInterpreter boolean required

    An interpreter read this petition to me in a language in which I am fluent

  • petitionerInterpreterLanguage string optional

    Language in which the interpreter read this petition to the petitioner

    length: 0–60
  • petitionerUsedPreparer boolean required

    A preparer, at my request, prepared this petition based on information I provided or authorized

  • petitionerDaytimePhoneNumber string required

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

    pattern
  • petitionerMobilePhoneNumber string optional

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

    pattern
  • petitionerEmail string optional

    Personal identifier; handle as sensitive data.

    length: 0–160
  • petitionerSignatureDate date required

    Date of petitioner's signature

Interpreter and preparer (if used)

  • interpreterFamilyName string optional

    Interpreter's family name

    length: 0–100
  • interpreterGivenName string optional

    Interpreter's given name

    length: 0–100
  • interpreterBusinessOrOrganizationName string optional

    Interpreter's business or organization name, if any

    length: 0–150
  • interpreterAddressLine1 string optional

    Street number and name.

    length: 1–120
  • interpreterAddressApt string optional

    If applicable.

    length: 0–20
  • interpreterAddressCity string optional

    City or town component of the address.

    length: 0–80
  • interpreterAddressState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • interpreterAddressZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • interpreterAddressProvince string optional

    For a foreign address.

    length: 0–60
  • interpreterAddressPostalCode string optional

    For a foreign address.

    length: 0–15
  • interpreterAddressCountry string optional

    Country component of the address.

    length: 0–60
  • interpreterDaytimePhoneNumber string optional

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

    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

    Date of interpreter's signature

  • preparerFamilyName string optional

    Preparer's family name

    length: 0–100
  • preparerGivenName string optional

    Preparer's given name

    length: 0–100
  • preparerBusinessOrOrganizationName string optional

    Preparer's business or organization name, if any

    length: 0–150
  • preparerAddressLine1 string optional

    Street number and name.

    length: 1–120
  • preparerAddressApt string optional

    If applicable.

    length: 0–20
  • preparerAddressCity string optional

    City or town component of the address.

    length: 0–80
  • preparerAddressState string optional

    US state/territory postal abbreviation for a U.S. address; leave blank for a foreign address (use the matching Province field).

    length: 0–60
  • preparerAddressZipCode string optional

    Required for a U.S. address.

    length: 0–15
  • preparerAddressProvince string optional

    For a foreign address.

    length: 0–60
  • preparerAddressPostalCode string optional

    For a foreign address.

    length: 0–15
  • preparerAddressCountry string optional

    Country component of the address.

    length: 0–60
  • preparerDaytimePhoneNumber string optional

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

    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

    Is the preparer an attorney or accredited representative?

  • preparerRepresentationExtendsBeyondPreparation boolean optional

    If true, the preparer may need to submit Form G-28, Notice of Entry of Appearance as Attorney or Accredited Representative, with this petition.

  • preparerSignatureDate date optional

    Date of preparer's signature

Verification record

This file is the source-review record for this document version, per the manual-source-review-v1 practice. It documents the provenance of the published fields and flow, records a mock-data test run of the field set, and states the current verification claim honestly.

Current claim

  • status: draft
  • verification.method: manual-source-review-v1
  • verification.lastVerifiedAt: 2026-07-02

The document was derived from and cross-checked against the official source below, but the full field-by-field comparison the practice requires (manual-source-review-v1 → Procedure step 2) has not yet been independently re-verified by a second reviewer. It therefore remains draft, not verified.

Why this candidate was advanced now

us/uscis/petition-alien-relative-i130 is GOV-664 plan §2 item F1.4 — priority-ordered federal immigration authoring, alongside the same wave's other USCIS candidates (N-400, I-765, I-485, I-131). It is the relationship-establishing petition that gates us/uscis/adjustment-of-status-i485 in the two-step "petition, then adjust status" agent story (I-130 approval, or a concurrently-filed I-130/I-485 package, precedes I-485 for an immediate-relative beneficiary already in the United States).

Sources examined

  • Document (id, version): us/uscis/petition-alien-relative-i130 / 1.0.0
  • Spec version: GovSchema 0.3.0
  • Authority: U.S. Citizenship and Immigration Services (USCIS)
  • Primary source URL: https://www.uscis.gov/i-130
  • Official form id: Form I-130 (Edition 04/01/24)
  • Form PDF: https://www.uscis.gov/sites/default/files/document/forms/i-130.pdf — fetched directly over HTTPS with a browser user agent (a plain unauthenticated curl to www.uscis.gov without a user agent returns HTTP 403; adding one succeeds, matching the WAF behavior already documented for other USCIS forms in this registry). Parsed with pdfjs-dist's getFieldObjects() (AcroForm/XFA field inventory, including checkbox/radio exportValues) and getTextContent() per page (12 pages), and cross-checked against Instructions for Form I-130 (https://www.uscis.gov/sites/default/files/document/forms/i-130instr.pdf, 11 pages, plain text) for eligibility rules, item-by-item guidance (Parts 3, 6, 7, 8), and confirmation that Form I-130A (Supplemental Information for a Spouse Beneficiary) is a companion form, not part of this document.
  • Retrieved / reviewed: 2026-07-02
  • Reviewer: GovSchema Engineering (initial authoring source-review)

Not a time-versioned (edition) form

A relationship petition is a one-time filing per beneficiary, triggered by the existence of a qualifying family relationship — applying the GSP-0005 §2 coexistence test, there is no scenario where two editions of the I-130 data model need to coexist for the same petitioner/beneficiary pair. This document is therefore authored at the plain (non-edition) registry path, registry/us/uscis/petition-alien-relative-i130/1.0.0/. A future form revision (the form itself is dated per edition, e.g. "04/01/24") that changes the field set ships as a new version, not an edition.

A known AcroForm field-numbering quirk

The extracted PDF's internal AcroForm field names (e.g. Pt4Line56_*, Part4Line1_Yes) do not consistently align 1:1 with the form's printed Part/item numbers — a revision evidently inserted or renumbered printed items without renaming the underlying AcroForm fields, a quirk already observed on other USCIS forms in this registry (see the I-90 VERIFICATION.md height/weight note). sourceRef values in this schema cite the printed Part/item numbers (what a human or an agent reading the rendered PDF sees), reconstructed by correlating each internal field's page-text position with its checkbox/radio exportValues, not the raw internal field names.

Scope decisions

Form I-130 covers two natural persons in full (the petitioner and the beneficiary) plus a relationship-history section, an interpreter, and a preparer — by far the largest field set of any process modeled in this registry to date. The following simplifications keep the document focused on the fields that gate eligibility, identity, and the I-485/consular-processing routing decision, consistent with how prior documents in this registry (e.g. us/irs/individual-income-tax-return-1040's single modeled dependent1* slot against the paper form's four) have handled genuinely bounded multi-slot sections:

  • Part 9 (Additional Information) is an open-ended continuation space for overflow answers from any other part; out of scope, the same treatment given to equivalent continuation sections elsewhere in this registry (e.g. Form I-90 Part 8).
  • Prior-spouse history (petitioner items 20-23, beneficiary items 21-24) models the current/most-recent spouse only (petitionerSpouse1*, beneficiarySpouse1*); the form's second historical-spouse slot is out of scope.
  • "Information About Beneficiary's Family" (items 25-44) provides five fixed person slots; this document models Person 1 only (beneficiaryFamilyPerson1*); Persons 2-5 are out of scope.
  • "Other relatives you are also filing for" (items 6-9) provides two relative slots; this document models Relative 1 only (relative1*); Relative 2 is out of scope.
  • Petitioner's 5-year physical-address history (items 12-15) provides two dated address slots; this document models the current physical address only (petitionerPhysicalAddress*, gated on petitionerMailingSameAsPhysical); the second (older) historical address and both slots' date ranges are out of scope.
  • Petitioner's and beneficiary's 5-year employment history (petitioner items 42-49, beneficiary items 51-52) is out of scope entirely — it is supporting evidentiary context, not eligibility-gating data, and no other field's visibility/requiredness depends on it.
  • Petitioner's parents (items 24-35) are modeled at reduced granularity (petitionerParent1FamilyName/GivenName/MiddleName/DateOfBirth/ CountryOfBirth, and the same five for Parent 2) — sex and current city/country of residence are out of scope.
  • petitionerRace (Part 3, "select all applicable boxes") is modeled as a single string field documented to hold a comma-separated list of the five source category values, rather than an array type — the same treatment used for Form I-90's equivalent field, since v0.3 has no native multi-select field type (tracked alongside GSP-0009).
  • Mutually exclusive Part 4 item 61/62 selection ("select only 1 option to indicate adjustment of status or consular processing," per the form's own instructions banner) is modeled as a single beneficiaryApplicationType enum field (adjustment_of_status | consular_processing) with the office/post location fields gated by GSP-0013 requiredWhen, rather than as two raw independent Yes/No checkboxes — this is a structural interpretation of the source's explicit business rule, not a literal 1:1 field transcription.

Unlike the v0.2-authored us/uscis/permanent-resident-card-replacement-i90, this document is authored directly against v0.3 and uses GSP-0013 requiredWhen throughout (interpreter/preparer sub-fields, citizenship-basis branching, marital-status-gated fields, the adjustment-of-status/consular selector) instead of prose-only conditional notes.

What was confirmed against the source

  • Process identity. Confirmed Form I-130 (Edition 04/01/24) is the current USCIS form for establishing a qualifying family relationship for immigration purposes, distinct from Form I-130A (a companion form for a spouse beneficiary, referenced but not modeled — same treatment as this registry gives Form G-28 in us/uscis/permanent-resident-card-replacement-i90), Form I-485 (adjustment of status, the downstream filing this petition gates), and Form I-90 (Green Card renewal for an existing permanent resident, not a relationship petition).
  • Full section-by-section field set, transcribed field-by-field from the decoded PDF text and cross-checked against the checkbox/radio exportValues inventory: Part 1 relationship type and its child/parent/sibling sub-branches; Part 2 petitioner identity, A-Number, other names, mailing/physical address, marital history, parents, and the U.S.-citizen/lawful-permanent-resident branch with certificate and admission sub-fields; Part 3 petitioner biographic information (ethnicity, race, height, weight, eye color, hair color); Part 4 beneficiary identity, addresses, contact information, marital history, family, U.S. entry and immigration-proceedings history, passport/travel-document information, the native-written-language name/address fields, the spousal last-address-together fields, and the adjustment-of-status/consular-post routing fields; Part 5 prior-petition and other-relative disclosures; Part 6 petitioner's statement, contact information, and signature; Part 7 interpreter's contact information and signature; Part 8 preparer's contact information, attorney/accredited-representative branch, and signature.
  • Eligibility framing from the Instructions document: who may/may not file (spouse, parent, sibling, child categories; the adoption, stepparent, and prior-marriage restrictions); the two-photo and I-130A requirements for spouse beneficiaries; the derivative-beneficiary treatment of a listed beneficiary's spouse/children under Items 4-5 of "Who May File."

Mock-data test run

Per the issue's instruction to test-run the schema with valid mock data, a representative filled-out petition was authored and checked field-by-field against every type/required/requiredWhen/validation constraint in schema.json (string length, regex pattern, enum membership, integer minimum/maximum, date format, boolean type, and effective requiredness computed from the GSP-0013 Condition grammar):

``json { "relationshipToBeneficiary": "spouse", "petitionerGainedStatusThroughAdoption": false, "petitionerFamilyName": "Alvarez", "petitionerGivenName": "Marco", "petitionerCityOfBirth": "Tampa", "petitionerCountryOfBirth": "United States", "petitionerDateOfBirth": "1988-04-12", "petitionerSex": "male", "petitionerMailingAddressLine1": "455 Bayshore Blvd", "petitionerMailingAddressCity": "Tampa", "petitionerMailingAddressState": "FL", "petitionerMailingAddressZipCode": "33606", "petitionerMailingAddressCountry": "United States", "petitionerMailingSameAsPhysical": true, "petitionerCurrentMaritalStatus": "married", "petitionerDateOfCurrentMarriage": "2024-06-01", "petitionerCitizenshipBasis": "us_citizen", "petitionerCitizenshipAcquiredThrough": "birth_in_us", "petitionerHasCertificateOfNaturalizationOrCitizenship": false, "petitionerEthnicity": "not_hispanic_or_latino", "petitionerRace": "white", "petitionerHeightFeet": 5, "petitionerHeightInches": 11, "petitionerWeightPounds": 180, "petitionerEyeColor": "brown", "petitionerHairColor": "black", "beneficiaryFamilyName": "Alvarez", "beneficiaryGivenName": "Elena", "beneficiaryCityOfBirth": "Guadalajara", "beneficiaryCountryOfBirth": "Mexico", "beneficiaryDateOfBirth": "1990-09-23", "beneficiarySex": "female", "beneficiaryEverFiledForByOthers": "no", "beneficiaryPhysicalAddressLine1": "455 Bayshore Blvd", "beneficiaryPhysicalAddressCity": "Tampa", "beneficiaryPhysicalAddressState": "FL", "beneficiaryPhysicalAddressZipCode": "33606", "beneficiaryPhysicalAddressCountry": "United States", "beneficiaryCurrentMaritalStatus": "married", "beneficiaryDateOfCurrentMarriage": "2024-06-01", "beneficiaryEverInUs": true, "beneficiaryClassOfAdmission": "B2", "beneficiaryI94Number": "12345678901", "beneficiaryDateOfArrival": "2023-01-15", "beneficiaryAuthorizedStayExpirationDate": "2023-07-14", "beneficiaryEverInImmigrationProceedings": false, "beneficiaryLastAddressTogetherLine1": "455 Bayshore Blvd", "beneficiaryLastAddressTogetherCity": "Tampa", "beneficiaryLastAddressTogetherState": "FL", "beneficiaryLastAddressTogetherCountry": "United States", "beneficiaryLastAddressTogetherDateFrom": "2023-06-01", "beneficiaryLastAddressTogetherDateTo": "PRESENT", "beneficiaryApplicationType": "adjustment_of_status", "beneficiaryAdjustmentOfStatusUscisOfficeCity": "Tampa", "beneficiaryAdjustmentOfStatusUscisOfficeState": "FL", "petitionerEverFiledPetitionForBeneficiaryOrOtherAlien": false, "petitionerCanReadEnglish": true, "petitionerUsedInterpreter": false, "petitionerUsedPreparer": false, "petitionerDaytimePhoneNumber": "+18135550142", "petitionerSignatureDate": "2026-07-02" } ``

This models Marco Alvarez, a U.S. citizen petitioning for his spouse Elena Alvarez, a Mexican national already in the United States on a B-2 visitor visa who will seek adjustment of status at the Tampa USCIS field office (exercising the beneficiaryApplicationType: adjustment_of_status branch and its requiredWhen-gated office fields), with no interpreter or preparer used (exercising the petitionerCanReadEnglish: true path) and no prior petitions filed for any other alien. A one-off Node script (node:fs + a hand-rolled per-field validator that also evaluates each field's requiredWhen/required via the GSP-0013 Condition grammar) confirmed every populated field satisfies its type/validation constraint and that every field whose effective requiredness evaluates to true under this scenario was populated:

`` PASS — mock spousal I-130 petition (adjustment of status, no interpreter/preparer) satisfies all schema field-level constraints. ``

Both registry validators were run against the schema document itself (not the mock data) and pass:

``` $ node tools/validate.mjs registry/us/uscis/petition-alien-relative-i130/1.0.0/schema.json ok registry/us/uscis/petition-alien-relative-i130/1.0.0/schema.json

$ cd tools && node validate-ajv.mjs ../registry/us/uscis/petition-alien-relative-i130/1.0.0/schema.json ok registry/us/uscis/petition-alien-relative-i130/1.0.0/schema.json [v0.3] ```

A separate check confirmed every requiredWhen/visibleWhen field reference in the document names an existing sibling field (0 dangling references across 205 fields), and that no field combines a static required: true with requiredWhen (which the meta-schema itself also enforces via its allOf constraint).

What is NOT yet independently verified

  • The scope-decision field reductions above (prior-spouse slot 2, family Persons 2-5, relative 2, petitioner's second physical-address-history slot and both employment-history blocks, and the beneficiary's current-employer block) are documented simplifications, not gaps discovered during verification — a future version could add them back as a MINOR bump if a reviewer judges the fidelity trade-off should go the other way.
  • The AcroForm field-numbering quirk described above means a handful of sourceRef sub-item letters (particularly in the Part 2 employment/address history area, now out of scope, and the Part 4 items 55-62 area) were reconstructed from page-text position and cross-referenced against exportValues rather than read directly off an unambiguous internal field name; a second reviewer should re-confirm these against the live rendered PDF (e.g. in Adobe Acrobat) rather than the text/field extraction used here.
  • beneficiaryClassOfAdmission/petitionerClassOfAdmission as free text. Neither the form nor the fetched Instructions enumerates the full set of admission-class codes (e.g. B2, IR1, CR1); free text is a reasonable encoding, not a citation of a published enumerated list.
  • Constraint patterns (phone E.164, SSN, A-Number digit count) are reasonable encodings consistent with other documents in this registry, not citations of a published USCIS validation rule.
  • Form G-1055 (fee schedule) was not fetched this cycle (the /i-130 page defers filing-fee amounts to that separate, frequently-updated schedule); this schema does not encode a fee amount, consistent with every other document in this registry.
  • The online (myUSCIS) filing experience's exact screen flow was not directly observed; this document is sourced from the paper/PDF Form I-130 itself, not a live capture of the online filing wizard. The source page confirms Form I-130 can be filed online or by mail, and that Form I-485 cannot currently be filed online even when I-130 is filed online.
  • The out-of-scope Part 9 continuation section and Form I-130A (spouse beneficiary supplement) are documented as such but not modeled or independently verified field-by-field.

Path to a verified claim (next step)

To advance this document to status: verified, a reviewer applies manual-source-review-v1 (Procedure step 2 field-by-field comparison, step 3 flow comparison) against the live Form I-130 PDF and Instructions, confirms the sources are still authoritative, resolves any discrepancy by shipping a new schema version (immutability — VERSIONING §3, practice Procedure step 5), and records the outcome here plus sets status: verified with a current verification.lastVerifiedAt/nextReviewBy. This v1.0.0 record stays as the authoring provenance.

Re-verification

Per the practice's Cadence, nextReviewBy is set to 2027-01-02 (6 months). Re-check the source on or before that date, on any source.url change, or when USCIS publishes a new Form I-130 edition (the form is dated per edition, e.g. "04/01/24").

View the raw record (VERIFICATION.md)

Version history

  • 1.0.0 draft latest this page has verification record schema.json

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.