> ## Documentation Index
> Fetch the complete documentation index at: https://help.elationhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Patient Form Request Object

This object represents a patient form request, which is an association between a `Patient` and a set of `PatientForm`.\
You must first create the `PatientForm` before you can associate them to a `PatientFormRequest`.  A `PatientFormRequest`\
can be Read, Created, and Updated.

<Warning>
  When modifying via a PUT request, `notification_date` is the only field that can be changed.
</Warning>

## Example Object

Here's an example `PatientFormRequest`:

```json theme={null}
{
  "created_date": "2024-01-18T00:00:00Z", // datetime(ISO-8601), read-only
  "forms_url": "http://sandbox.elationemr.com/practice/{practice_id}/patient/{patient_id}/patient-forms/?key=AZCaFB2ZF28fyD1PijUHaRFYtLuIe6MFxOanGXMV", // string, read-only
  "id": 61253,                            // long(64), read-only
  "notification_date": "2024-01-19",      // date(YYYY-MM-DD)
  "patient": 585983,                      // long(64), required
  "patient_forms": [                      // array[long(64)], required
    58165,
    78952
  ],
  "practice": 581663                      // long(64), read-only
}
```

## Field Definitions

| Field | Required | Read Only | Type | Description |
| - | - | - | - | - |
| id | No | Yes | long(64) | The unique identifier for the `PatientFormRequest`. |
| patient | Yes | No | long(64) | The unique identifier for the `Patient` associated with the `PatientFormRequest`. |
| practice | No | Yes | long(64) | The unique identifier for the `Practice` associated with the `PatientFormRequest`. |
| forms\_url | No | Yes | string | This is the anonymous URL that can be used to access the forms. |
| notification\_date | No | No | date | The date the `PatientFormRequest` was sent to the patient. This follows the format: `YYYY-MM-DD`.  Any other format will result in an error. |
| patient\_forms | Yes | No | array\[long(64)] | An array of `PatientForm` IDs associated with the `PatientFormRequest`. |
| created\_date | No | Yes | datetime | The date the `PatientFormRequest` was created. |