VA Form 21-2680 ยท v3.1
Aid and Attendance or Housebound examination
Veteran completes Section I. Section II is routed to a physician on a single-use link and returns automatically.
1 field has no downstream target
Those answers are captured on the intake record but are not sent anywhere yet. A person has to choose the mapping before they can flow downstream.
7 fields in v3.1
Each field records where it came from on the paper form, so a reviewer can always trace a digital answer back to the box it replaced.
| Type | Required | On the paper form | Maps to | |
|---|---|---|---|---|
| veteran_full_nameVeteran's full name | Text | Yes | Page 1, Section I, box 1 | claimant.fullName |
| va_file_numberVA file number | Text | Yes | Page 1, Section I, box 2 | claimant.fileNumber |
| care_settingCurrent care setting | Choice | Yes | Page 1, Section I, box 6 | pension.careSetting |
| examining_physicianExamining physician | Text | Yes | Page 2, Section II, box 1 | exam.providerName |
| requires_assistance_bathingRequires assistance bathing | Yes/No | Yes | Page 2, Section II, box 9a | exam.adl.bathing |
| physician_signature_datePhysician signature date | Date | Yes | Page 3, Section II, box 21 | exam.signedOn |
| additional_remarksAdditional remarks | Text | No | Page 3, Section II, box 20 | Unmapped |
Field schema for VA Form 21-2680
- Field
- veteran_full_nameVeteran's full name
- Type
- Text
- Required
- Yes
- On the paper form
- Page 1, Section I, box 1
- Maps to
- claimant.fullName
- Field
- va_file_numberVA file number
- Type
- Text
- Required
- Yes
- On the paper form
- Page 1, Section I, box 2
- Maps to
- claimant.fileNumber
- Field
- care_settingCurrent care setting
- Type
- Choice
- Required
- Yes
- On the paper form
- Page 1, Section I, box 6
- Maps to
- pension.careSetting
- Field
- examining_physicianExamining physician
- Type
- Text
- Required
- Yes
- On the paper form
- Page 2, Section II, box 1
- Maps to
- exam.providerName
- Field
- requires_assistance_bathingRequires assistance bathing
- Type
- Yes/No
- Required
- Yes
- On the paper form
- Page 2, Section II, box 9a
- Maps to
- exam.adl.bathing
- Field
- physician_signature_datePhysician signature date
- Type
- Date
- Required
- Yes
- On the paper form
- Page 3, Section II, box 21
- Maps to
- exam.signedOn
- Field
- additional_remarksAdditional remarks
- Type
- Text
- Required
- No
- On the paper form
- Page 3, Section II, box 20
- Maps to
- Unmapped
Validation rules
A rule can block a submission, warn the person filling it out, or flag the record for a person to review. No rule approves, denies, or prices anything.
| Field | Rule | When it fires | Effect |
|---|---|---|---|
| va_file_number | Must be 8 or 9 digits, or a valid Social Security number | On the Veteran's section, before the link is generated | Blocks submission |
| physician_signature_date | Cannot be in the future, and cannot precede the exam date | When the provider returns Section II | Blocks submission |
| care_setting | Nursing home selection requires a facility name | As the Veteran answers | Warns the filer |
| additional_remarks | Over 500 characters routes to manual review | On intake, after the form is complete | Flags for review |
Validation rules for VA Form 21-2680
- Field
- va_file_number
- Rule
- Must be 8 or 9 digits, or a valid Social Security number
- When it fires
- On the Veteran's section, before the link is generated
- Effect
- Blocks submission
- Field
- physician_signature_date
- Rule
- Cannot be in the future, and cannot precede the exam date
- When it fires
- When the provider returns Section II
- Effect
- Blocks submission
- Field
- care_setting
- Rule
- Nursing home selection requires a facility name
- When it fires
- As the Veteran answers
- Effect
- Warns the filer
- Field
- additional_remarks
- Rule
- Over 500 characters routes to manual review
- When it fires
- On intake, after the form is complete
- Effect
- Flags for review
Downstream mapping
Where each answer lands: VBMS - Pension claim package.
Mapped (6)
- veteran_full_nameclaimant.fullName
- va_file_numberclaimant.fileNumber
- care_settingpension.careSetting
- examining_physicianexam.providerName
- requires_assistance_bathingexam.adl.bathing
- physician_signature_dateexam.signedOn
Not mapped (1)
- additional_remarks
Captured on the intake record. Waiting for someone to choose a downstream target.
Test submissions
Synthetic payloads run against the current schema. A failed test means a rule caught something, which is usually the point.
Run a test submission
Sends a synthetic payload through validation and the downstream mapping. Nothing reaches a real system of record.
| Test case | Run on | Result | What happened |
|---|---|---|---|
| Complete package, nursing home setting | July 22, 2026 | Passed | All 7 fields mapped. Landed in VBMS in 40 seconds. |
| Provider signed with a future date | July 21, 2026 | Failed | Blocked by physician_signature_date. Expected - the rule worked. |
| Remarks field over length | July 21, 2026 | Passed | Accepted and flagged for manual review, as designed. |
Test submissions for VA Form 21-2680
- Test case
- Complete package, nursing home setting
- Run on
- July 22, 2026
- Result
- Passed
- What happened
- All 7 fields mapped. Landed in VBMS in 40 seconds.
- Test case
- Provider signed with a future date
- Run on
- July 21, 2026
- Result
- Failed
- What happened
- Blocked by physician_signature_date. Expected - the rule worked.
- Test case
- Remarks field over length
- Run on
- July 21, 2026
- Result
- Passed
- What happened
- Accepted and flagged for manual review, as designed.