{
  "$schema": "https://govschema.org/spec/v0.1/govschema.schema.json",
  "govschemaVersion": "0.1.0",
  "id": "us/dos/passport-renewal-ds82",
  "version": "1.0.0",
  "title": "United States Passport Renewal by Mail (Form DS-82)",
  "description": "Renewal of a U.S. passport book and/or card by mail for eligible adults using Department of State Form DS-82. This document describes the eligibility conditions, the applicant inputs, and the by-mail flow. It does not submit the form; the live travel.state.gov source is always authoritative (see verification).",
  "status": "draft",
  "jurisdiction": {
    "country": "US",
    "level": "national"
  },
  "authority": {
    "name": "U.S. Department of State, Bureau of Consular Affairs",
    "abbreviation": "DOS",
    "url": "https://travel.state.gov/"
  },
  "process": {
    "type": "renewal",
    "language": "en-US"
  },
  "source": {
    "url": "https://travel.state.gov/en/passports/renew-replace/mail.html",
    "retrievedAt": "2026-06-30",
    "documentRef": "DS-82"
  },
  "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 'Renew Your Passport by Mail' page and Form DS-82. Eligibility conditions confirmed against the source; applicant input fields reflect the form's structure but are not yet independently re-verified item-by-item. Status remains 'draft'. Fees and processing times are intentionally not encoded. See VERIFICATION.md."
  },
  "license": "CC-BY-4.0",
  "fields": [
    {
      "name": "passportLostOrStolen",
      "label": "Has your most recent passport ever been reported lost or stolen?",
      "type": "boolean",
      "required": true,
      "description": "If your most recent passport was reported lost or stolen, you cannot renew by mail with Form DS-82 and must apply in person.",
      "sourceRef": "Eligibility: passport never reported lost or stolen"
    },
    {
      "name": "passportIssuedWithin15Years",
      "label": "Was your most recent passport issued within the last 15 years?",
      "type": "boolean",
      "required": true,
      "description": "Count from the issue date printed on your passport to today. A passport issued more than 15 years ago is not eligible for renewal by mail.",
      "sourceRef": "Eligibility: passport issued within the last 15 years"
    },
    {
      "name": "passportIssuedAge16OrOlder",
      "label": "Were you age 16 or older when your most recent passport was issued, and was it valid for 10 years?",
      "type": "boolean",
      "required": true,
      "description": "Passports issued to applicants under age 16 (and other limited-validity passports) generally cannot be renewed by mail. You cannot renew a passport for a child under 16.",
      "sourceRef": "Eligibility: passport issued at age 16 or older and valid for 10 years"
    },
    {
      "name": "canSubmitMostRecentPassport",
      "label": "Can you submit your most recent passport with your application?",
      "type": "boolean",
      "required": true,
      "description": "Your most recent passport must be mailed in with the application.",
      "sourceRef": "Eligibility: can submit most recent passport"
    },
    {
      "name": "nameMatchesOrHaveDocumentation",
      "label": "Was your passport issued in your current name, or can you document a name change?",
      "type": "boolean",
      "required": true,
      "description": "Answer yes if the name on your passport is your current name, or if you can provide a certified marriage certificate, divorce decree, or court order showing the change.",
      "sourceRef": "Eligibility: issued in current name or name-change document available"
    },
    {
      "name": "passportUndamaged",
      "label": "Is your passport undamaged (other than normal wear and tear)?",
      "type": "boolean",
      "required": true,
      "description": "A damaged passport (beyond normal wear) cannot be renewed by mail and must be replaced in person.",
      "sourceRef": "Eligibility: passport not damaged other than normal wear and tear"
    },
    {
      "name": "lastName",
      "label": "Last name (as it should appear on the passport)",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 item 1 — Name",
      "validation": { "minLength": 1, "maxLength": 100 }
    },
    {
      "name": "firstName",
      "label": "First name",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 item 1 — Name",
      "validation": { "minLength": 1, "maxLength": 100 }
    },
    {
      "name": "middleName",
      "label": "Middle name",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 item 1 — Name",
      "validation": { "maxLength": 100 }
    },
    {
      "name": "dateOfBirth",
      "label": "Date of birth",
      "type": "date",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Full date, YYYY-MM-DD.",
      "sourceRef": "DS-82 item 2 — Date of Birth"
    },
    {
      "name": "placeOfBirth",
      "label": "Place of birth (city and state, or city and country)",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 item 3 — Place of Birth",
      "validation": { "minLength": 1, "maxLength": 120 }
    },
    {
      "name": "sexMarker",
      "label": "Sex marker to appear on the passport",
      "type": "enum",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. F = Female, M = Male, X = Unspecified or another gender identity.",
      "sourceRef": "DS-82 — Sex",
      "validation": { "enum": ["F", "M", "X"] }
    },
    {
      "name": "socialSecurityNumber",
      "label": "Social Security number",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Enter your 9-digit U.S. Social Security number. Federal law requires it for a passport application; if you have never been issued one, the live form provides an alternative attestation.",
      "sourceRef": "DS-82 — Social Security Number",
      "validation": { "pattern": "^[0-9]{9}$" }
    },
    {
      "name": "mailingAddressLine1",
      "label": "Mailing address — street address",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 — Mailing Address",
      "validation": { "minLength": 1, "maxLength": 120 }
    },
    {
      "name": "mailingAddressLine2",
      "label": "Mailing address — apartment, suite, or unit (optional)",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 — Mailing Address",
      "validation": { "maxLength": 120 }
    },
    {
      "name": "mailingAddressCity",
      "label": "Mailing address — city",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 — Mailing Address",
      "validation": { "minLength": 1, "maxLength": 80 }
    },
    {
      "name": "mailingAddressState",
      "label": "Mailing 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": "DS-82 — Mailing Address",
      "validation": { "pattern": "^[A-Z]{2}$" }
    },
    {
      "name": "mailingAddressPostalCode",
      "label": "Mailing 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": "DS-82 — Mailing Address",
      "validation": { "pattern": "^[0-9]{5}(-[0-9]{4})?$" }
    },
    {
      "name": "email",
      "label": "Email address",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. A valid email address.",
      "sourceRef": "DS-82 — Email Address",
      "validation": { "maxLength": 254 }
    },
    {
      "name": "phone",
      "label": "Phone number",
      "type": "string",
      "required": false,
      "description": "Personal identifier; handle as sensitive data. In international E.164 format, e.g. +12025551234.",
      "sourceRef": "DS-82 — Phone Number",
      "validation": { "pattern": "^\\+[1-9][0-9]{1,14}$" }
    },
    {
      "name": "mostRecentPassportFullName",
      "label": "Full name as printed on your most recent passport",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data.",
      "sourceRef": "DS-82 — Most Recent Passport: Name as printed",
      "validation": { "minLength": 1, "maxLength": 200 }
    },
    {
      "name": "mostRecentPassportNumber",
      "label": "Most recent passport number",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. The number printed on the passport book or card you are renewing. U.S. passport numbers are typically 6 to 9 characters; older books may be all digits and newer ones may begin with a letter.",
      "sourceRef": "DS-82 — Most Recent Passport: Passport Number",
      "validation": { "pattern": "^[A-Za-z0-9]{6,9}$" }
    },
    {
      "name": "mostRecentPassportIssueDate",
      "label": "Issue date of your most recent passport",
      "type": "date",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Full date, YYYY-MM-DD.",
      "sourceRef": "DS-82 — Most Recent Passport: Issue Date"
    },
    {
      "name": "nameChangeDocument",
      "label": "Name-change document (only if your current name differs from the passport)",
      "type": "file",
      "required": false,
      "description": "A certified copy of a marriage certificate, divorce decree, or court order. Required only if the name on your most recent passport is not your current name. Provide as PDF, JPEG, or PNG; the live source publishes size limits.",
      "sourceRef": "Required submission: name-change document (if applicable)"
    },
    {
      "name": "photo",
      "label": "Passport photo",
      "type": "file",
      "required": true,
      "description": "One color photograph meeting the published U.S. passport photo requirements (2x2 inches, plain background, taken within the last 6 months). Provide as JPEG or PNG; the live source publishes size limits.",
      "sourceRef": "Required submission: one photograph"
    },
    {
      "name": "productRequested",
      "label": "What are you renewing?",
      "type": "enum",
      "required": true,
      "description": "book = Passport book; card = Passport card; book_and_card = Both passport book and card.",
      "sourceRef": "DS-82 — Passport book and/or card",
      "validation": { "enum": ["book", "card", "book_and_card"] }
    },
    {
      "name": "serviceSpeed",
      "label": "Processing speed",
      "type": "enum",
      "required": true,
      "description": "routine = Routine service; expedited = Expedited service (additional fee, faster). Current processing times and fees are published on the live source.",
      "sourceRef": "DS-82 — Routine or expedited service",
      "validation": { "enum": ["routine", "expedited"] }
    },
    {
      "name": "paymentMethod",
      "label": "Payment method",
      "type": "enum",
      "required": true,
      "description": "check = Personal check; money_order = Money order. Renewals by mail are paid by personal check or money order payable to the U.S. Department of State. Confirm the current fee on the live source.",
      "sourceRef": "Required submission: payment by check or money order",
      "validation": { "enum": ["check", "money_order"] }
    }
  ],
  "steps": [
    {
      "id": "eligibility",
      "title": "Check you can renew by mail",
      "fields": [
        "passportLostOrStolen",
        "passportIssuedWithin15Years",
        "passportIssuedAge16OrOlder",
        "canSubmitMostRecentPassport",
        "nameMatchesOrHaveDocumentation",
        "passportUndamaged"
      ],
      "next": "applicant_details"
    },
    {
      "id": "applicant_details",
      "title": "Your details",
      "fields": [
        "lastName",
        "firstName",
        "middleName",
        "dateOfBirth",
        "placeOfBirth",
        "sexMarker",
        "socialSecurityNumber",
        "mailingAddressLine1",
        "mailingAddressLine2",
        "mailingAddressCity",
        "mailingAddressState",
        "mailingAddressPostalCode",
        "email",
        "phone"
      ],
      "next": "most_recent_passport"
    },
    {
      "id": "most_recent_passport",
      "title": "Your most recent passport",
      "fields": [
        "mostRecentPassportFullName",
        "mostRecentPassportNumber",
        "mostRecentPassportIssueDate",
        "nameChangeDocument"
      ],
      "next": "supporting_items"
    },
    {
      "id": "supporting_items",
      "title": "Photo, product, and payment",
      "fields": ["photo", "productRequested", "serviceSpeed", "paymentMethod"]
    }
  ]
}