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

# Create Lab Report



## OpenAPI

````yaml post /v1/labs
openapi: 3.1.0
info:
  title: ClinikAPI
  version: 1.0.0
  description: >
    ClinikAPI is a managed healthcare infrastructure platform providing a
    developer-friendly REST API

    for storing, querying, and managing clinical data using the FHIR R4
    standard.


    ## Authentication

    All endpoints (except `/v1/metadata` and `/health`) require an API key via
    the `x-api-key` header.

    - Production keys: `clk_live_*`

    - Test/sandbox keys: `clk_test_*`


    ## Response Format

    All responses are wrapped in `{ data: T, meta: { requestId, timestamp,
    status, rateLimitTotal, rateLimitRemaining, rateLimitReset } }`.


    ## Rate Limits

    Rate limits are plan-based and returned in response headers:

    - `X-RateLimit-Limit` — total requests allowed per window

    - `X-RateLimit-Remaining` — requests remaining

    - `X-RateLimit-Reset` — seconds until window resets


    ## Overages

    Requests beyond your plan limit are charged at $0.003/request.
  contact:
    name: ClinikAPI Support
    email: support@clinikapi.com
    url: https://clinikapi.com
  license:
    name: Proprietary
servers:
  - url: https://api.clinikapi.com
    description: Production
  - url: http://localhost:3000
    description: Local development
security:
  - ApiKeyAuth: []
tags:
  - name: System
    description: Health check and metadata
  - name: Patients
    description: Patient demographics and records
  - name: Practitioners
    description: Healthcare providers and clinicians
  - name: PractitionerRoles
    description: Practitioner roles, specialties, and availability
  - name: Encounters
    description: Clinical visits and interactions
  - name: Observations
    description: Vitals, lab values, and clinical measurements
  - name: Medications
    description: Drug catalog entries
  - name: Appointments
    description: Scheduling and booking
  - name: Prescriptions
    description: Medication orders (MedicationRequest)
  - name: Intakes
    description: Questionnaire responses and intake forms
  - name: Consents
    description: Privacy and treatment consent directives
  - name: Labs
    description: Diagnostic reports and lab results
  - name: Notes
    description: Clinical notes and documents (DocumentReference)
  - name: Assessments
    description: Clinical impressions and evaluations
  - name: Documents
    description: Structured clinical documents (Composition)
  - name: Devices
    description: Medical devices, equipment, and implantable hardware
  - name: DeviceRequests
    description: Orders and proposals for device use
  - name: DeviceUseStatements
    description: Records of device use on patients
  - name: Goals
    description: Patient care goals and targets
  - name: Invoices
    description: Healthcare billing invoices
  - name: MedicationDispenses
    description: Pharmacy medication dispensing records
  - name: MedicationKnowledge
    description: Drug reference data and formulary information
  - name: MedicationStatements
    description: Patient-reported medication usage records
  - name: PaymentNotices
    description: Payment status notifications between payers and providers
  - name: PaymentReconciliations
    description: Detailed payment settlement information with line-item breakdowns
  - name: Specimens
    description: Biological samples collected from patients for laboratory testing
  - name: ImagingStudies
    description: Radiology and diagnostic imaging exams with series-level detail
  - name: EnrollmentRequests
    description: Insurance enrollment requests for patients
  - name: EnrollmentResponses
    description: Insurer responses to enrollment requests
  - name: ImmunizationEvaluations
    description: Evaluation of immunization events against protocol requirements
  - name: Media
    description: Clinical images, videos, and audio recordings
  - name: AuditEvents
    description: Security-relevant event records for compliance and audit trails
  - name: Measures
    description: Quality measures and clinical performance metric definitions
  - name: MeasureReports
    description: Results of evaluating quality measures against populations or patients
  - name: ImmunizationRecommendations
    description: Patient-specific vaccine recommendations based on immunization history
  - name: Bulk
    description: Bulk import and export operations
  - name: FHIR Passthrough
    description: Raw FHIR R4 access with tenant isolation
paths:
  /v1/labs:
    post:
      tags:
        - Labs
      summary: Create lab report
      operationId: createLab
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LabCreate'
      responses:
        '201':
          description: Lab report created
components:
  schemas:
    LabCreate:
      type: object
      required:
        - status
        - code
        - patientId
      properties:
        status:
          type: string
          enum:
            - registered
            - partial
            - preliminary
            - final
            - amended
            - corrected
            - appended
            - cancelled
        code:
          $ref: '#/components/schemas/CodeableConcept'
        patientId:
          type: string
        encounterId:
          type: string
        effectiveDateTime:
          type: string
          format: date-time
          description: When the report is clinically relevant (point in time)
        effectivePeriod:
          type: object
          description: When the report is clinically relevant (time range)
          properties:
            start:
              type: string
              format: date-time
            end:
              type: string
              format: date-time
        resultIds:
          type: array
          items:
            type: string
          description: Observation IDs included in this report
        category:
          type: string
          description: LAB, RAD, PAT
        conclusion:
          type: string
          maxLength: 5000
        conclusionCodes:
          type: array
          items:
            type: object
            properties:
              system:
                type: string
              code:
                type: string
              display:
                type: string
        performer:
          type: string
          description: Practitioner who performed the diagnostic
        resultsInterpreter:
          type: string
          description: Practitioner who interpreted results
        specimenIds:
          type: array
          items:
            type: string
        presentedForm:
          type: array
          items:
            type: object
            properties:
              contentType:
                type: string
              data:
                type: string
              url:
                type: string
              title:
                type: string
        basedOn:
          type: array
          description: ServiceRequest IDs this report is based on
          items:
            type: string
        media:
          type: array
          description: Media/images linked to this report
          items:
            type: object
            properties:
              comment:
                type: string
              linkId:
                type: string
                description: Media resource ID
    CodeableConcept:
      oneOf:
        - type: string
        - type: object
          properties:
            system:
              type: string
            code:
              type: string
            display:
              type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your ClinikAPI secret key (clk_live_* or clk_test_*)

````