---
title: "Find form by form name"
method: GET
path: "/forms/{form_name}"
tags: ["Forms"]
---

# Find form by form name

`GET /forms/{form_name}`

Returns a single form and the full revision history

## Path parameters

- `form_name` string, required

## Response `200`

VA Form Show response

- object
  - `data` FormShow, required — Data for a particular VA form, including form version history.
    - `id` string — JSON API identifier
    - `type` string — JSON API type specification
    - `attributes` object
      - `form_name` string — Name of the VA Form
      - `url` string — Web location of the form
      - `title` string — Title of the form as given by VA
      - `first_issued_on` string, date, nullable — The date the form first became available
      - `last_revision_on` string, date, nullable — The date the form was last updated
      - `created_at` string, date-time, nullable — Internal field for VA.gov use
      - `pages` integer — Number of pages contained in the form
      - `sha256` string, nullable — A sha256 hash of the form contents
      - `valid_pdf` boolean — A flag indicating whether the form url was confirmed as a valid download
      - `form_usage` string, nullable — A description of how the form is to be used
      - `form_tool_intro` string, nullable — Introductory text describing the VA online tool for this form
      - `form_tool_url` string, nullable — Location of the online tool for this form
      - `form_details_url` string, nullable — Location on www.va.gov of the info page for this form
      - `form_type` string, nullable — VA Type of the form
      - `language` string, nullable — Language code of the form
      - `deleted_at` string, date-time, nullable — The timestamp at which the form was deleted
      - `related_forms` string[], nullable — A listing of other forms that relate to current form
      - `benefit_categories` object[], nullable — Listing of benefit categories and match
        - `name` string — Name of the benefit category of the form
        - `description` string — Description of the benefit category of the form
      - `va_form_administration` string, nullable — The VA organization that administers the form
      - `versions` object[], nullable — The version history of revisions to the form
        - `sha256` string — A sha256 hash of the form contents for that version
        - `revision_on` string, date — The date the sha256 hash was calculated

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.dev/va/apis/va-forms.md) · [All operations](https://skmtc.dev/va/apis/va-forms/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/va/va-forms/revisions/eacfd5073af9/schema)