# CreateRapidTestResponse

Model ID: `CreateRapidTestResponse`

Response for POST /patients/{patient_id}/diagnostics/rapid-tests.
Extends RapidTest with the best-effort Athena mirror outcome.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `athena_error` | `string|null` | No |  |  |  | Yes | Reason the Athena mirror failed, only present when athena_status is 'failed'. |
| `athena_order_id` | `string|null` | No |  |  |  | Yes | The Athena lab order id the result document ties to, only present when athena_status is 'linked'. |
| `athena_status` | `string|null` | No |  |  |  | Yes | Outcome of mirroring this result to Athena. `linked` means the diagnosis + lab order + lab result document (with image, when scan_storage_key was supplied) were created in Athena. `skipped_no_athena` means the tenant is not Athena-integrated; `skipped_unlinked` means the patient has no athena_patient_id; `skipped_no_encounter` means neither encounter_id nor athena_encounter_id was supplied; `skipped_no_athena_encounter` means the given FHIR Encounter has no linked Athena encounter id. Absent entirely when the request supplied neither encounter_id nor athena_encounter_id. |
| `collected_by` | `string|null` | No |  |  |  | Yes | Name of the person who collected the specimen, optional. |
| `derived_from` | `array|null` | No |  |  |  | Yes | FHIR resource IDs this observation is derived from, e.g. ['Media/{id}'] for the captured test-kit image. Per FHIR R4 Observation.derivedFrom. |
| `device_name` | `string|null` | No |  |  |  | Yes | CLIA-waived device make/model |
| `encounter_id` | `string|null` | No |  |  |  | Yes | FHIR Encounter ID this test is associated with, optional. |
| `fhir_id` | `string|null` | No |  |  |  | Yes | FHIR Observation resource ID; set once the record has been persisted. |
| `lot_number` | `string|null` | No |  |  |  | Yes | Test kit lot number, optional. |
| `notes` | `string|null` | No |  |  |  | Yes | Free-text notes, optional. |
| `performed_by` | `string|null` | No |  |  |  | Yes | Name of the person who performed the test, optional. |
| `performed_date` | `string|null` | No |  |  |  | Yes | ISO 8601 date the test was performed, when time-of-day is not tracked. |
| `performed_datetime` | `string|null` | No |  |  |  | Yes | ISO 8601 datetime the test was performed, optional. |
| `quantitative_unit` | `string|null` | No |  |  |  | Yes | Unit of measure for quantitative_value, optional. |
| `quantitative_value` | `number|null` | No |  |  |  | Yes | Numeric result value, for tests that report a quantitative reading. Requires quantitative_unit. |
| `result` | [`RapidTestResult`](./RapidTestResult.md) | No |  |  |  | Yes | The qualitative result, when available. |
| `specimen_type` | [`SpecimenType`](./SpecimenType.md) | No |  |  | `"nasopharyngeal_swab"` | No | Type of specimen the test was run on. |
| `status` | [`ObservationStatus`](./ObservationStatus.md) | No |  |  | `"final"` | No | Observation lifecycle status. |
| `test_id` | `string` | No | uuid |  |  | No | Internal identifier generated at construction time; the FHIR resource id (fhir_id) is the one used elsewhere as {test_id}. |
| `type` | [`RapidTestType`](./RapidTestType.md) | Yes |  |  |  | No | Which rapid test kit was used, e.g. covid19, influenza_a, pregnancy. |

## Example

None declared in canonical OpenAPI.