{
  "$schema": "https://govschema.org/spec/v0.1/govschema.schema.json",
  "govschemaVersion": "0.1.0",
  "id": "us/uscis/change-of-address-ar11",
  "version": "1.0.0",
  "title": "United States Alien's Change of Address (Form AR-11)",
  "description": "Report a change of address to U.S. Citizenship and Immigration Services using Form AR-11, as required of most non-citizens within 10 days of moving. This document describes the registrant's identity, the old and new addresses, the move date, and any pending USCIS cases that should also be updated. It does not submit the form; the live uscis.gov source is always authoritative (see verification).",
  "status": "draft",
  "jurisdiction": {
    "country": "US",
    "level": "national"
  },
  "authority": {
    "name": "U.S. Citizenship and Immigration Services",
    "abbreviation": "USCIS",
    "url": "https://www.uscis.gov/"
  },
  "process": {
    "type": "amendment",
    "language": "en-US"
  },
  "source": {
    "url": "https://www.uscis.gov/ar-11",
    "retrievedAt": "2026-06-30",
    "documentRef": "AR-11"
  },
  "verification": {
    "method": "manual-source-review-v1",
    "lastVerifiedAt": "2026-06-30",
    "verifiedBy": "GovSchema Engineering",
    "nextReviewBy": "2026-12-30",
    "notes": "Source-derived reference schema authored from the official USCIS AR-11 page and the AR-11 form. The 10-day filing rule, the identity block (name, date of birth, country of birth, A-Number), the old/new address pair, the date of move, and the pending-case reporting were confirmed against the source; individual input fields reflect the form's structure but are not yet independently re-verified item-by-item. The legal 10-day deadline is a temporal rule that v0.1 cannot encode as a constraint and is recorded in field descriptions. Status remains 'draft'. See VERIFICATION.md."
  },
  "license": "CC-BY-4.0",
  "fields": [
    {
      "name": "lastName",
      "label": "Family name (last name)",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Your current legal family name.",
      "sourceRef": "AR-11 — Your Full Name: Family Name",
      "validation": { "minLength": 1, "maxLength": 100 }
    },
    {
      "name": "firstName",
      "label": "Given name (first name)",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — Your Full Name: Given Name",
      "validation": { "minLength": 1, "maxLength": 100 }
    },
    {
      "name": "middleName",
      "label": "Middle name",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — Your Full Name: Middle Name",
      "validation": { "maxLength": 100 }
    },
    {
      "name": "otherNamesUsed",
      "label": "Other names you have used",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. Any other names you have ever used, including aliases and maiden name.",
      "sourceRef": "AR-11 — Other names used",
      "validation": { "maxLength": 200 }
    },
    {
      "name": "dateOfBirth",
      "label": "Date of birth",
      "type": "date",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Full date, YYYY-MM-DD.",
      "sourceRef": "AR-11 — Date of Birth"
    },
    {
      "name": "countryOfBirth",
      "label": "Country of birth",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — Country of Birth",
      "validation": { "minLength": 1, "maxLength": 80 }
    },
    {
      "name": "countryOfCitizenship",
      "label": "Country of citizenship or nationality",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — Country of Citizenship/Nationality",
      "validation": { "minLength": 1, "maxLength": 80 }
    },
    {
      "name": "alienRegistrationNumber",
      "label": "Alien Registration Number (A-Number)",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. Your USCIS A-Number if you have one: the letter A followed by 7 to 9 digits (e.g. A012345678). Enter the digits with or without the leading A. Some registrants subject to address reporting do not yet have an A-Number.",
      "sourceRef": "AR-11 — Alien Registration Number (A-Number)",
      "validation": { "pattern": "^A?[0-9]{7,9}$" }
    },
    {
      "name": "uscisOnlineAccountNumber",
      "label": "USCIS Online Account Number",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. Your 12-digit USCIS Online Account Number, if you have created an online account. Leave blank if you do not have one.",
      "sourceRef": "AR-11 — USCIS Online Account Number",
      "validation": { "pattern": "^[0-9]{12}$" }
    },
    {
      "name": "oldAddressLine1",
      "label": "Previous address — street number and name",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. The U.S. address you are moving from.",
      "sourceRef": "AR-11 — Last (Previous) Address",
      "validation": { "minLength": 1, "maxLength": 120 }
    },
    {
      "name": "oldAddressLine2",
      "label": "Previous address — apartment, suite, or unit (optional)",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — Last (Previous) Address",
      "validation": { "maxLength": 120 }
    },
    {
      "name": "oldAddressCity",
      "label": "Previous address — city or town",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — Last (Previous) Address",
      "validation": { "minLength": 1, "maxLength": 80 }
    },
    {
      "name": "oldAddressState",
      "label": "Previous address — state or territory",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. Two-letter USPS state or territory abbreviation when the previous address is in the U.S.; omit for a foreign previous address.",
      "sourceRef": "AR-11 — Last (Previous) Address",
      "validation": { "pattern": "^[A-Z]{2}$" }
    },
    {
      "name": "oldAddressPostalCode",
      "label": "Previous address — ZIP / postal code",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. U.S. 5-digit or ZIP+4 format, e.g. 90210 or 90210-1234, when the previous address is in the U.S.",
      "sourceRef": "AR-11 — Last (Previous) Address",
      "validation": { "pattern": "^[0-9]{5}(-[0-9]{4})?$" }
    },
    {
      "name": "oldAddressCountry",
      "label": "Previous address — country",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Country of the previous address.",
      "sourceRef": "AR-11 — Last (Previous) Address",
      "validation": { "minLength": 1, "maxLength": 80 }
    },
    {
      "name": "newAddressLine1",
      "label": "New address — street number and name",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. The U.S. address you have moved to.",
      "sourceRef": "AR-11 — New Address",
      "validation": { "minLength": 1, "maxLength": 120 }
    },
    {
      "name": "newAddressLine2",
      "label": "New address — apartment, suite, or unit (optional)",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — New Address",
      "validation": { "maxLength": 120 }
    },
    {
      "name": "newAddressCity",
      "label": "New address — city or town",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "AR-11 — New Address",
      "validation": { "minLength": 1, "maxLength": 80 }
    },
    {
      "name": "newAddressState",
      "label": "New address — state or territory",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Two-letter USPS state or territory abbreviation, e.g. CA, NY, TX.",
      "sourceRef": "AR-11 — New Address",
      "validation": { "pattern": "^[A-Z]{2}$" }
    },
    {
      "name": "newAddressPostalCode",
      "label": "New address — ZIP code",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. 5-digit or ZIP+4 format, e.g. 90210 or 90210-1234.",
      "sourceRef": "AR-11 — New Address",
      "validation": { "pattern": "^[0-9]{5}(-[0-9]{4})?$" }
    },
    {
      "name": "dateOfMove",
      "label": "Date you moved to the new address",
      "type": "date",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. The date you began residing at the new address, YYYY-MM-DD. Federal law requires AR-11 to be filed within 10 days of this date; v0.1 cannot enforce that deadline as a constraint, so consumers should check it against the filing date.",
      "sourceRef": "AR-11 — Date you moved"
    },
    {
      "name": "hasPendingCase",
      "label": "Do you have any application, petition, or request pending with USCIS?",
      "type": "boolean",
      "required": true,
      "description": "If yes, the change of address should also be applied to those cases so notices reach the new address.",
      "sourceRef": "AR-11 — Pending applications/petitions"
    },
    {
      "name": "pendingCaseReceiptNumbers",
      "label": "Pending case form types and receipt numbers",
      "type": "string",
      "required": false,
      "description": "Required only when hasPendingCase is true. List each pending form type and its receipt number (e.g. 'I-485, IOE0123456789'). A USCIS receipt number is three letters followed by 10 digits.",
      "sourceRef": "AR-11 — Pending applications/petitions: form numbers and receipt numbers",
      "validation": { "maxLength": 600 }
    }
  ],
  "steps": [
    {
      "id": "registrant",
      "title": "Your identity",
      "fields": [
        "lastName",
        "firstName",
        "middleName",
        "otherNamesUsed",
        "dateOfBirth",
        "countryOfBirth",
        "countryOfCitizenship",
        "alienRegistrationNumber",
        "uscisOnlineAccountNumber"
      ],
      "next": "old_address"
    },
    {
      "id": "old_address",
      "title": "Previous address",
      "fields": [
        "oldAddressLine1",
        "oldAddressLine2",
        "oldAddressCity",
        "oldAddressState",
        "oldAddressPostalCode",
        "oldAddressCountry"
      ],
      "next": "new_address"
    },
    {
      "id": "new_address",
      "title": "New address",
      "fields": [
        "newAddressLine1",
        "newAddressLine2",
        "newAddressCity",
        "newAddressState",
        "newAddressPostalCode"
      ],
      "next": "move_and_cases"
    },
    {
      "id": "move_and_cases",
      "title": "Move date and pending cases",
      "fields": ["dateOfMove", "hasPendingCase", "pendingCaseReceiptNumbers"]
    }
  ]
}