# Create diagnostic request

Creates a new Diagnostic Request record. Diagnostic Request resource in the Animal Health Data Store

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

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `animalId` (string, required)
    Animal for which the diagnostics are requested.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `consultId` (string, required)
    Consult/visit associated with this diagnostic request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string, required)
    Owner or client contact associated with the request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `diagnosticItems` (array, required)
    List of individual diagnostics requested as part of this request.

  - `diagnosticItems.code` (string)
    Practice or supplier-specific code for the diagnostic test.

  - `diagnosticItems.createdAt` (string)
    When this diagnostic item was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `diagnosticItems.diagnosticClass` (string)
    Category or class of the diagnostic test.

  - `diagnosticItems.diagnosticId` (string, required)
    Reference to the catalog diagnostic/test being requested.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `diagnosticItems.diagnosticRequestItemId` (string, required)
    Canonical identifier for this diagnostic request item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `diagnosticItems.isActive` (boolean)
    Whether this diagnostic item is currently active.

  - `diagnosticItems.name` (string)
    Human-readable name of the diagnostic test.

  - `diagnosticItems.updatedAt` (string)
    When this diagnostic item was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `diagnosticRequestId` (string, required)
    Canonical identifier for the diagnostic request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

  - `isActive` (boolean, required)
    Whether the diagnostic request is currently active.

  - `ownershipId` (string, required)
    Ownership or billing entity associated with the request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `referenceNumber` (string)
    External or practice-specific reference number for the diagnostic request.

  - `requestedAt` (string, required)
    Business timestamp associated with the diagnostic request (e.g., when it was requested).
    Example: "2025-01-01T00:00:00.000Z"

  - `specifics` (string, required)
    Free-text details or instructions for the diagnostic request.

  - `status` (string, required)
    Status of the diagnostic request.
    Enum: "draft", "requested", "in-progress", "completed", "cancelled", "entered-in-error", "unknown"

  - `supplierId` (string, required)
    External laboratory or supplier handling the diagnostics.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `vetId` (string, required)
    Veterinarian responsible for the diagnostic request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

## Response 201 fields (application/json):

  - `animalId` (string, required)
    Animal for which the diagnostics are requested.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `consultId` (string, required)
    Consult/visit associated with this diagnostic request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contactId` (string, required)
    Owner or client contact associated with the request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `createdAt` (string, required)
    When the diagnostic request was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `diagnosticItems` (array, required)
    List of individual diagnostics requested as part of this request.

  - `diagnosticItems.code` (string)
    Practice or supplier-specific code for the diagnostic test.

  - `diagnosticItems.createdAt` (string)
    When this diagnostic item was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `diagnosticItems.diagnosticClass` (string)
    Category or class of the diagnostic test.

  - `diagnosticItems.diagnosticId` (string, required)
    Reference to the catalog diagnostic/test being requested.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `diagnosticItems.diagnosticRequestItemId` (string, required)
    Canonical identifier for this diagnostic request item.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `diagnosticItems.isActive` (boolean)
    Whether this diagnostic item is currently active.

  - `diagnosticItems.name` (string)
    Human-readable name of the diagnostic test.

  - `diagnosticItems.updatedAt` (string)
    When this diagnostic item was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `diagnosticRequestId` (string, required)
    Canonical identifier for the diagnostic request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

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

  - `isActive` (boolean, required)
    Whether the diagnostic request is currently active.

  - `ownershipId` (string, required)
    Ownership or billing entity associated with the request.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `referenceNumber` (string, required)
    External or practice-specific reference number for the diagnostic request.

  - `requestedAt` (string, required)
    Business timestamp associated with the diagnostic request (e.g., when it was requested).
    Example: "2025-01-01T00:00:00.000Z"

  - `specifics` (string, required)
    Free-text details or instructions for the diagnostic request.

  - `status` (string, required)
    Status of the diagnostic request.
    Enum: "draft", "requested", "in-progress", "completed", "cancelled", "entered-in-error", "unknown"

  - `supplierId` (string, required)
    External laboratory or supplier handling the diagnostics.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `updatedAt` (string, required)
    When the diagnostic request was last updated.
    Example: "2025-01-01T00:00:00.000Z"

  - `vetId` (string, required)
    Veterinarian responsible for the diagnostic request.
    Example: "123e4567-e89b-12d3-a456-426614174000"


## Response 400 fields

## Response 401 fields

## Response 409 fields