# Create standard diagnostic lab report

Creates a new Standard Diagnostic Lab Report record. Standard Diagnostic Lab Report resource in the Animal Health Data Store

Endpoint: POST /site/{siteId}/ahds/v1/standard-diagnostic-lab-report
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `accessionNumber` (string)
    Laboratory accession or case number assigned by the performing lab.

  - `animalId` (string, required)
    Reference to the animal this lab report is associated with.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `attachments` (array)
    Associated documents or images (e.g., PDF report, radiology images).

  - `attachments.attachmentId` (string)
    Identifier for the attachment resource.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `attachments.title` (string)
    Human-readable title for the attachment.

  - `attachments.type` (string)
    Type of attachment (e.g., 'pdf', 'image', 'dicom').

  - `attachments.url` (string)
    Location where the attachment can be retrieved.

  - `clientProvidedId` (string)
    Optional client-supplied identifier used for idempotency or cross-system correlation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `collectedAt` (string)
    Date and time when the specimen was collected.
    Example: "2025-01-01T00:00:00.000Z"

  - `conclusion` (string)
    Overall textual conclusion or summary from the lab.

  - `encounterId` (string)
    Reference to the clinical encounter or visit during which this lab report was ordered or reviewed.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `extensions` (object)
    Vendor- or practice-specific extensions.

  - `notes` (array)
    General notes about the lab report.

  - `notes.authorId` (string)
    Identifier of the user or system that authored the note.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `notes.createdAt` (string)
    When the note was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `notes.text` (string, required)
    Note text.

  - `orderId` (string)
    Reference to the associated diagnostic order, if tracked separately.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `orderedAt` (string)
    Date and time when the lab tests were ordered.
    Example: "2025-01-01T00:00:00.000Z"

  - `orderingVeterinarianId` (string)
    Reference to the veterinarian who ordered the diagnostic test(s).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `performingLabOrganizationId` (string)
    Reference to the external or internal laboratory organization that performed the tests.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `receivedAt` (string)
    Date and time when the specimen was received by the performing lab.
    Example: "2025-01-01T00:00:00.000Z"

  - `recommendations` (string)
    Recommendations or comments from the lab regarding follow-up or interpretation.

  - `reportCode` (object)
    Code describing the type of lab report (e.g., chemistry panel, CBC).

  - `reportCode.code` (string, required)
    Code value

  - `reportCode.system` (string, required)
    Code system URI

  - `reportCode.display` (string)
    Human-readable display

  - `reportStatus` (string, required)
    Overall status of the lab report.
    Enum: "registered", "partial", "final", "corrected", "cancelled", "entered-in-error"

  - `reportedAt` (string)
    Date and time when the final (or current) report was issued.
    Example: "2025-01-01T00:00:00.000Z"

  - `requestingClinicId` (string)
    Reference to the clinic or practice that requested the lab work.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `results` (array)
    Individual test results included in this lab report.

  - `results.interpretation` (object)
    Clinical interpretation of the result (e.g., high, low, normal).

  - `results.note` (string)
    Free-text comments specific to this result.

  - `results.observedAt` (string)
    Date and time when the measurement or observation was made.
    Example: "2025-01-01T00:00:00.000Z"

  - `results.referenceRange` (object)
    Reference range for this test result.

  - `results.resultId` (string)
    Identifier for this specific result within the report, if available.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `results.status` (string)
    Status of this individual result.
    Enum: "registered", "partial", "final", "corrected", "cancelled", "entered-in-error"

  - `results.testCode` (object)
    Code for the specific test performed.

  - `results.valueCode` (object)
    Coded representation of the result value, when applicable.

  - `results.valueQuantity` (object)
    Numeric result value with units.

  - `results.valueQuantity.value` (number, required)
    Numeric value

  - `results.valueQuantity.unit` (string, required)
    Unit of measure

  - `results.valueQuantity.system` (string)
    Unit system URI

  - `results.valueString` (string)
    Non-numeric result value (e.g., 'positive', 'negative', 'growth').

  - `specimens` (array)
    Specimens used for this lab report.

  - `specimens.bodySite` (object)
    Body site from which the specimen was collected.

  - `specimens.clientProvidedId` (string)
    Client- or lab-supplied specimen identifier (e.g., tube barcode).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `specimens.collectedAt` (string)
    Date and time when this specimen was collected.
    Example: "2025-01-01T00:00:00.000Z"

  - `specimens.collectionMethod` (object)
    How the specimen was collected (e.g., venipuncture).

  - `specimens.note` (string)
    Free-text notes about the specimen.

  - `specimens.specimenId` (string)
    Identifier for the specimen record, if tracked.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `specimens.type` (object)
    Type of specimen (e.g., blood, urine).

  - `standardDiagnosticLabReportId` (string, required)
    Canonical identifier for this standard diagnostic lab report.
    Example: "123e4567-e89b-12d3-a456-426614174000"

## Response 201 fields (application/json):

  - `accessionNumber` (string, required)
    Laboratory accession or case number assigned by the performing lab.

  - `animalId` (string, required)
    Reference to the animal this lab report is associated with.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `attachments` (array, required)
    Associated documents or images (e.g., PDF report, radiology images).

  - `attachments.attachmentId` (string)
    Identifier for the attachment resource.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `attachments.title` (string)
    Human-readable title for the attachment.

  - `attachments.type` (string)
    Type of attachment (e.g., 'pdf', 'image', 'dicom').

  - `attachments.url` (string)
    Location where the attachment can be retrieved.

  - `clientProvidedId` (string, required)
    Optional client-supplied identifier used for idempotency or cross-system correlation.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `collectedAt` (string, required)
    Date and time when the specimen was collected.
    Example: "2025-01-01T00:00:00.000Z"

  - `conclusion` (string, required)
    Overall textual conclusion or summary from the lab.

  - `createdAt` (string, required)
    Timestamp when this lab report record was created in the AHDS system.
    Example: "2025-01-01T00:00:00.000Z"

  - `encounterId` (string, required)
    Reference to the clinical encounter or visit during which this lab report was ordered or reviewed.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `notes` (array, required)
    General notes about the lab report.

  - `notes.authorId` (string)
    Identifier of the user or system that authored the note.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `notes.createdAt` (string)
    When the note was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `notes.text` (string, required)
    Note text.

  - `orderId` (string, required)
    Reference to the associated diagnostic order, if tracked separately.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `orderedAt` (string, required)
    Date and time when the lab tests were ordered.
    Example: "2025-01-01T00:00:00.000Z"

  - `orderingVeterinarianId` (string, required)
    Reference to the veterinarian who ordered the diagnostic test(s).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `performingLabOrganizationId` (string, required)
    Reference to the external or internal laboratory organization that performed the tests.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `receivedAt` (string, required)
    Date and time when the specimen was received by the performing lab.
    Example: "2025-01-01T00:00:00.000Z"

  - `recommendations` (string, required)
    Recommendations or comments from the lab regarding follow-up or interpretation.

  - `reportCode` (object, required)
    Code describing the type of lab report (e.g., chemistry panel, CBC).

  - `reportCode.code` (string, required)
    Code value

  - `reportCode.system` (string, required)
    Code system URI

  - `reportCode.display` (string)
    Human-readable display

  - `reportStatus` (string, required)
    Overall status of the lab report.
    Enum: "registered", "partial", "final", "corrected", "cancelled", "entered-in-error"

  - `reportedAt` (string, required)
    Date and time when the final (or current) report was issued.
    Example: "2025-01-01T00:00:00.000Z"

  - `requestingClinicId` (string, required)
    Reference to the clinic or practice that requested the lab work.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `results` (array, required)
    Individual test results included in this lab report.

  - `results.interpretation` (object)
    Clinical interpretation of the result (e.g., high, low, normal).

  - `results.note` (string)
    Free-text comments specific to this result.

  - `results.observedAt` (string)
    Date and time when the measurement or observation was made.
    Example: "2025-01-01T00:00:00.000Z"

  - `results.referenceRange` (object)
    Reference range for this test result.

  - `results.resultId` (string)
    Identifier for this specific result within the report, if available.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `results.status` (string)
    Status of this individual result.
    Enum: "registered", "partial", "final", "corrected", "cancelled", "entered-in-error"

  - `results.testCode` (object)
    Code for the specific test performed.

  - `results.valueCode` (object)
    Coded representation of the result value, when applicable.

  - `results.valueQuantity` (object)
    Numeric result value with units.

  - `results.valueQuantity.value` (number, required)
    Numeric value

  - `results.valueQuantity.unit` (string, required)
    Unit of measure

  - `results.valueQuantity.system` (string)
    Unit system URI

  - `results.valueString` (string)
    Non-numeric result value (e.g., 'positive', 'negative', 'growth').

  - `specimens` (array, required)
    Specimens used for this lab report.

  - `specimens.bodySite` (object)
    Body site from which the specimen was collected.

  - `specimens.clientProvidedId` (string)
    Client- or lab-supplied specimen identifier (e.g., tube barcode).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `specimens.collectedAt` (string)
    Date and time when this specimen was collected.
    Example: "2025-01-01T00:00:00.000Z"

  - `specimens.collectionMethod` (object)
    How the specimen was collected (e.g., venipuncture).

  - `specimens.note` (string)
    Free-text notes about the specimen.

  - `specimens.specimenId` (string)
    Identifier for the specimen record, if tracked.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `specimens.type` (object)
    Type of specimen (e.g., blood, urine).

  - `standardDiagnosticLabReportId` (string, required)
    Canonical identifier for this standard diagnostic lab report.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `updatedAt` (string, required)
    Timestamp when this lab report record was last updated in the AHDS system.
    Example: "2025-01-01T00:00:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 409 fields