# CreateRapidTestRequest

Model ID: `CreateRapidTestRequest`

Rapid point-of-care test result to record for a patient.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `administered_date` | `string` | No |  |  |  | No | ISO date or date-time; accepted as an alias for performed_date/performed_datetime (hc/apis/diagnostics/src/app.py::create_rapid_test). |
| `athena_encounter_id` | `string` | No |  |  |  | No | Athena encounter id to mirror this result onto directly, optional. Overrides the encounter_id -> FHIR Encounter lookup when the caller already knows it. |
| `device_name` | `string` | No |  |  |  | No | CLIA-waived device make/model, optional. |
| `encounter_id` | `string` | No |  |  |  | No | FHIR Encounter id this test is associated with, optional. When the tenant has Athena and the patient is linked, this is used to resolve athena_encounter_id (from the Encounter's Athena extension) for the best-effort Athena mirror. Required for the Athena mirror to run unless athena_encounter_id is supplied directly. |
| `lot_number` | `string` | No |  |  |  | No | Test kit lot number, optional. |
| `notes` | `string` | No |  |  |  | No | Free-text notes, optional. |
| `performed_date` | `string` | No | date |  |  | No | ISO 8601 date the test was performed, optional. |
| `performed_datetime` | `string` | No | date-time |  |  | No | ISO 8601 datetime the test was performed, optional. |
| `quantitative_unit` | `string` | No |  |  |  | No | Unit of measure for quantitative_value, optional. |
| `quantitative_value` | `number` | No |  |  |  | No | Numeric result value, for tests that report a quantitative reading. Requires quantitative_unit. |
| `result` | [`RapidTestResult`](./RapidTestResult.md) | No |  |  |  | No | The qualitative result, optional. |
| `scan_storage_key` | `string` | No |  |  |  | No | SAFE CDX S3 object key of the captured test-strip image (from diagnostics.getScanUploadUrl), optional. When present and the Athena mirror runs, the image is attached to the Athena lab result document; when absent, the Athena mirror still runs but without an image attachment. |
| `specimen_type` | [`SpecimenType`](./SpecimenType.md) | No |  |  |  | No | Type of specimen the test was run on. Defaults to nasopharyngeal_swab if omitted. |
| `type` | [`RapidTestType`](./RapidTestType.md) | No |  |  |  | No | Which rapid test kit was used. Defaults to 'other' if omitted. |

## Example

None declared in canonical OpenAPI.