Hint Health

Hint Health LabInteraction API

The LabInteraction API from Hint Health — 2 operation(s) for labinteraction.

GitHub OpenAPI
Business capability
Diagnostic Results Management BC-2860.60

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /provider/patients/{patient_id}/interactions/lab Record a lab order for a patient · Create Lab Interaction #
Ask an LLM
“How do I push a lab order and its results into a patient's chart?”
“Can I attach a lab report when recording a lab interaction?”
Tell an agent
Create a lab interaction for patient {patient_id}.
Record lab order {vendor_order_id} for patient {patient_id} with status {status}.
GET /provider/patients/{patient_id}/interactions/lab/{id} Look up a patient's lab interaction · Show Lab Interaction #
Ask an LLM
“What results came back on a specific lab order?”
“Can I view one lab interaction for a patient?”
Tell an agent
Show lab interaction {id} for patient {patient_id}.
Get the results of lab {id} on patient {patient_id}.
PATCH /provider/patients/{patient_id}/interactions/lab/{id} Update a patient's lab interaction · Update Lab Interaction #
Ask an LLM
“Can I add results to a lab order after it was created?”
“Is it possible to change the status of an existing lab interaction?”
Tell an agent
Set lab interaction {id} on patient {patient_id} to status {status}.
Add results {results} to lab {id} for patient {patient_id}.

Documentation

📖
Documentation
https://developers.hint.com/docs/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hint-health/refs/heads/main/openapi/hint-health-labinteraction-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hint-health/refs/heads/main/json-schema/hint-health-interaction-lab-sanitizer-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hint-health/refs/heads/main/json-schema/hint-health-public-interaction-lab-blueprint-one-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/hint-health/refs/heads/main/overlays/hint-health-labinteraction-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hint-health:hint-health-labinteraction-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hint-health-labinteraction-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hint Health Lab Interaction API
  license:
    name: Private
  termsOfService: https://www.hint.com/terms
  x-refined-note:
  - x-api-evangelist-harvest differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged LabInteraction across 2 of this provider''s published API definitions: hint-health-hint-health-api-openapi.yml, hint-health-partner-endpoints-2026-07-01-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.hint.com/api
  description: Production
- url: https://api.sandbox.hint.com/api
  description: Sandbox
tags:
- name: LabInteraction
paths:
  /provider/patients/{patient_id}/interactions/lab:
    post:
      tags:
      - LabInteraction
      operationId: LabInteraction.CreateLabInteraction
      summary: Create Lab Interaction
      description: ''
      parameters:
      - name: patient_id
        in: path
        required: true
        description: Unique Patient ID
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.Interaction.LabBlueprint_one'
              example:
                id: inter-2f93f9da35eb293f
                event_timestamp: '2017-02-05T14:23:00Z'
                status: fulfilled
                type: lab
                vendor_order_id: '123456'
                order:
                  lab_reference_id: ord-ref-123456
                  ordered_from: San Francisco Lab
                  authored_on: '2017-02-05T14:23:00Z'
                  collected_at: '2017-02-05T14:23:00Z'
                  author: John Doe
                  author_reference: aut-ref-123456
                  intent: diagnostic
                  lab_account_id: lab-acc-123456
                  actions:
                  - reference: act-ref-123
                    display: LabCorp
                  subject:
                    reference: sub-ref-456
                    display: John Doe
                report:
                  issued: '2017-02-05T14:23:00Z'
                  status: final
                  lab_reference_id: lab-ref-123456
                  order_reference: order-ref-123456
                results:
                - id: res-id-123
                  code_text: lab-code-text-123
                  issued: '2017-02-05T14:23:00Z'
                  value_string: 100 mg/dL
                  text: Normal
                  interpretation:
                  - normal
                  subject: John Doe
                  code:
                  - code: lab-code-123
                    display: lab-code-display-123
                  value_quantity:
                    value: 100
                    unit: mg/dL
                  ranges:
                  - text: 120-140 mg/dL
                    low:
                      value: 120
                      unit: mg/dL
                    high:
                      value: 140
                      unit: mg/dL
                - id: res-id-456
                  code_text: lab-code-text-456
                  issued: '2017-02-05T14:23:00Z'
                  value_string: 110 mg/dL
                  text: Normal
                  interpretation:
                  - normal
                  subject: John Doe
                  code:
                  - code: lab-code-456
                    display: lab-code-display-456
                  value_quantity:
                    value: 110
                    unit: mg/dL
                  ranges:
                  - text: 100-120 mg/dL
                    low:
                      value: 100
                      unit: mg/dL
                    high:
                      value: 120
                      unit: mg/dL
                integration_error_message: null
                integration_last_synced_at: null
                integration_record_id: null
                integration_sync_status: enabled
                integration_web_link: null
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Interaction.LabSanitizer'
      security:
      - BearerAuth: []
    servers:
    - url: https://api.hint.com/api
      description: Production
    - url: https://api.sandbox.hint.com/api
      description: Sandbox
  /provider/patients/{patient_id}/interactions/lab/{id}:
    get:
      tags:
      - LabInteraction
      operationId: LabInteraction.ShowLabInteraction
      summary: Show Lab Interaction
      description: ''
      parameters:
      - name: patient_id
        in: path
        required: true
        description: Unique Patient ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Unique Lab Interaction ID
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.Interaction.LabBlueprint_one'
              example:
                id: inter-2f93f9da35eb293f
                event_timestamp: '2017-02-05T14:23:00Z'
                status: fulfilled
                type: lab
                vendor_order_id: '123456'
                order:
                  lab_reference_id: ord-ref-123456
                  ordered_from: San Francisco Lab
                  authored_on: '2017-02-05T14:23:00Z'
                  collected_at: '2017-02-05T14:23:00Z'
                  author: John Doe
                  author_reference: aut-ref-123456
                  intent: diagnostic
                  lab_account_id: lab-acc-123456
                  actions:
                  - reference: act-ref-123
                    display: LabCorp
                  subject:
                    reference: sub-ref-456
                    display: John Doe
                report:
                  issued: '2017-02-05T14:23:00Z'
                  status: final
                  lab_reference_id: lab-ref-123456
                  order_reference: order-ref-123456
                results:
                - id: res-id-123
                  code_text: lab-code-text-123
                  issued: '2017-02-05T14:23:00Z'
                  value_string: 100 mg/dL
                  text: Normal
                  interpretation:
                  - normal
                  subject: John Doe
                  code:
                  - code: lab-code-123
                    display: lab-code-display-123
                  value_quantity:
                    value: 100
                    unit: mg/dL
                  ranges:
                  - text: 120-140 mg/dL
                    low:
                      value: 120
                      unit: mg/dL
                    high:
                      value: 140
                      unit: mg/dL
                - id: res-id-456
                  code_text: lab-code-text-456
                  issued: '2017-02-05T14:23:00Z'
                  value_string: 110 mg/dL
                  text: Normal
                  interpretation:
                  - normal
                  subject: John Doe
                  code:
                  - code: lab-code-456
                    display: lab-code-display-456
                  value_quantity:
                    value: 110
                    unit: mg/dL
                  ranges:
                  - text: 100-120 mg/dL
                    low:
                      value: 100
                      unit: mg/dL
                    high:
                      value: 120
                      unit: mg/dL
                integration_error_message: null
                integration_last_synced_at: null
                integration_record_id: null
                integration_sync_status: enabled
                integration_web_link: null
      security:
      - BearerAuth: []
    patch:
      tags:
      - LabInteraction
      operationId: LabInteraction.UpdateLabInteraction
      summary: Update Lab Interaction
      description: ''
      parameters:
      - name: patient_id
        in: path
        required: true
        description: Unique Patient ID
        schema:
          type: string
      - name: id
        in: path
        required: true
        description: Unique Lab Interaction ID
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.Interaction.LabBlueprint_one'
              example:
                id: inter-2f93f9da35eb293f
                event_timestamp: '2017-02-05T14:23:00Z'
                status: fulfilled
                type: lab
                vendor_order_id: '123456'
                order:
                  lab_reference_id: ord-ref-123456
                  ordered_from: San Francisco Lab
                  authored_on: '2017-02-05T14:23:00Z'
                  collected_at: '2017-02-05T14:23:00Z'
                  author: John Doe
                  author_reference: aut-ref-123456
                  intent: diagnostic
                  lab_account_id: lab-acc-123456
                  actions:
                  - reference: act-ref-123
                    display: LabCorp
                  subject:
                    reference: sub-ref-456
                    display: John Doe
                report:
                  issued: '2017-02-05T14:23:00Z'
                  status: final
                  lab_reference_id: lab-ref-123456
                  order_reference: order-ref-123456
                results:
                - id: res-id-123
                  code_text: lab-code-text-123
                  issued: '2017-02-05T14:23:00Z'
                  value_string: 100 mg/dL
                  text: Normal
                  interpretation:
                  - normal
                  subject: John Doe
                  code:
                  - code: lab-code-123
                    display: lab-code-display-123
                  value_quantity:
                    value: 100
                    unit: mg/dL
                  ranges:
                  - text: 120-140 mg/dL
                    low:
                      value: 120
                      unit: mg/dL
                    high:
                      value: 140
                      unit: mg/dL
                - id: res-id-456
                  code_text: lab-code-text-456
                  issued: '2017-02-05T14:23:00Z'
                  value_string: 110 mg/dL
                  text: Normal
                  interpretation:
                  - normal
                  subject: John Doe
                  code:
                  - code: lab-code-456
                    display: lab-code-display-456
                  value_quantity:
                    value: 110
                    unit: mg/dL
                  ranges:
                  - text: 100-120 mg/dL
                    low:
                      value: 100
                      unit: mg/dL
                    high:
                      value: 120
                      unit: mg/dL
                integration_error_message: null
                integration_last_synced_at: null
                integration_record_id: null
                integration_sync_status: enabled
                integration_web_link: null
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Interaction.LabSanitizer'
      security:
      - BearerAuth: []
    servers:
    - url: https://api.hint.com/api
      description: Production
    - url: https://api.sandbox.hint.com/api
      description: Sandbox
components:
  schemas:
    Public.Interaction.Lab.Order.SubjectBlueprint_leaf:
      type: object
      properties:
        reference:
          type: string
        display:
          type: string
    Interaction.LabSanitizer:
      type: object
      properties:
        status:
          type: string
          description: The status of the interaction. Defaults to "SENT"
          enum:
          - sent
          - fulfilled
        vendor_order_id:
          type: string
          description: External vendor order ID (used for idempotency)
        event_timestamp:
          type: string
          format: date-time
          description: Defaults to current time
        order:
          $ref: '#/components/schemas/Interaction.LabSanitizer.OrderSanitizer'
          description: Lab order details
        report:
          $ref: '#/components/schemas/Interaction.LabSanitizer.ReportSanitizer'
          description: Diagnostic report details
        results:
          type: array
          items:
            $ref: '#/components/schemas/Interaction.LabSanitizer.ResultSanitizer'
          description: Lab result observations
        integration_record_id:
          type: string
        integration_error_message:
          type: string
        integration_web_link:
          type: string
    Interaction.LabSanitizer.ResultSanitizer:
      type: object
      properties:
        id:
          type: string
          description: Unique result identifier
        code:
          type: array
          items:
            $ref: '#/components/schemas/Interaction.LabSanitizer.ResultCodeSanitizer'
          description: At least one coding entry (min 1)
        code_text:
          type: string
          description: Human-readable name for the result
        issued:
          type: string
          format: date-time
          description: When the result was issued
        value_quantity:
          $ref: '#/components/schemas/Interaction.LabSanitizer.ResultQuantitySanitizer'
          description: Numeric result value with unit
        value_string:
          type: string
          description: String result value
        text:
          type: string
          description: Additional narrative text
        interpretation:
          type: array
          items:
            type: string
          description: Interpretation codes (e.g., ["normal"])
        ranges:
          type: array
          items:
            $ref: '#/components/schemas/Interaction.LabSanitizer.ResultRangeSanitizer'
          description: Reference ranges
        subject:
          type: string
          description: Subject reference
      required:
      - id
      - code
      - code_text
      - issued
    Public.Interaction.Lab.Result.RangeBlueprint_leaf:
      type: object
      properties:
        text:
          type: string
        low:
          $ref: '#/components/schemas/Public.Interaction.Lab.Result.QuantityBlueprint_leaf'
        high:
          $ref: '#/components/schemas/Public.Interaction.Lab.Result.QuantityBlueprint_leaf'
    Interaction.LabSanitizer.ResultRangeSanitizer:
      type: object
      properties:
        low:
          $ref: '#/components/schemas/Interaction.LabSanitizer.ResultQuantitySanitizer'
          description: Lower bound of range
        high:
          $ref: '#/components/schemas/Interaction.LabSanitizer.ResultQuantitySanitizer'
          description: Upper bound of range
        text:
          type: string
          description: Textual range description
    Public.Interaction.Lab.ResultBlueprint_leaf:
      type: object
      properties:
        id:
          type: string
        code_text:
          type: string
        issued:
          type: string
        value_string:
          type: string
        text:
          type: string
        interpretation:
          type: string
        subject:
          type: string
        code:
          $ref: '#/components/schemas/Public.Interaction.Lab.Result.CodeBlueprint_leaf'
        value_quantity:
          $ref: '#/components/schemas/Public.Interaction.Lab.Result.QuantityBlueprint_leaf'
        ranges:
          $ref: '#/components/schemas/Public.Interaction.Lab.Result.RangeBlueprint_leaf'
    Interaction.LabSanitizer.OrderSanitizer:
      type: object
      properties:
        lab_reference_id:
          type: string
          description: External reference ID for the lab order
        ordered_from:
          type: string
          description: Lab provider name (e.g., "LabCorp")
        authored_on:
          type: string
          description: When the order was authored
        collected_at:
          type: string
          format: date-time
          description: When the specimen was collected
        author:
          type: string
          description: Name or ID of the ordering provider
        author_reference:
          type: string
          description: Reference identifier for the author
        actions:
          type: array
          items:
            $ref: '#/components/schemas/Interaction.LabSanitizer.ActionSanitizer'
          description: Ordered tests/panels
        intent:
          type: string
          description: Order intent
        subject:
          $ref: '#/components/schemas/Interaction.LabSanitizer.SubjectSanitizer'
          description: Subject of the lab order
        lab_account_id:
          type: string
          description: Lab account identifier
    Public.Interaction.Lab.ReportBlueprint_leaf:
      type: object
      properties:
        issued:
          type: string
        status:
          type: string
        lab_reference_id:
          type: string
        order_reference:
          type: string
    Public.Interaction.Lab.Result.CodeBlueprint_leaf:
      type: object
      properties:
        code:
          type: string
        display:
          type: string
    Public.Interaction.Lab.Result.QuantityBlueprint_leaf:
      type: object
      properties:
        value:
          type: string
        unit:
          type: string
    Public.Interaction.Lab.Order.ActionBlueprint_leaf:
      type: object
      properties:
        reference:
          type: string
        display:
          type: string
    Interaction.LabSanitizer.SubjectSanitizer:
      type: object
      properties:
        reference:
          type: string
          description: Subject reference ID
        display:
          type: string
          description: Subject display name
    Interaction.LabSanitizer.ResultCodeSanitizer:
      type: object
      properties:
        code:
          type: string
          description: LOINC code value (only LOINC is supported)
        display:
          type: string
          description: Human-readable name
      required:
      - code
      - display
    Public.Interaction.LabBlueprint_one:
      type: object
      properties:
        id:
          type: string
        event_timestamp:
          type: string
        status:
          type: string
        type:
          type: string
        vendor_order_id:
          type: string
        order:
          $ref: '#/components/schemas/Public.Interaction.Lab.OrderBlueprint_leaf'
        report:
          $ref: '#/components/schemas/Public.Interaction.Lab.ReportBlueprint_leaf'
        results:
          $ref: '#/components/schemas/Public.Interaction.Lab.ResultBlueprint_leaf'
    Public.Interaction.Lab.OrderBlueprint_leaf:
      type: object
      properties:
        lab_reference_id:
          type: string
        ordered_from:
          type: string
        authored_on:
          type: string
        collected_at:
          type: string
        author:
          type: string
        author_reference:
          type: string
        intent:
          type: string
        lab_account_id:
          type: string
        actions:
          $ref: '#/components/schemas/Public.Interaction.Lab.Order.ActionBlueprint_leaf'
        subject:
          $ref: '#/components/schemas/Public.Interaction.Lab.Order.SubjectBlueprint_leaf'
    Interaction.LabSanitizer.ReportSanitizer:
      type: object
      properties:
        issued:
          type: string
          format: date-time
          description: When the report was issued
        status:
          type: string
          description: Report status (e.g., "final", "preliminary")
        lab_reference_id:
          type: string
          description: External lab reference ID
        order_reference:
          type: string
          description: Reference to the originating order
      required:
      - issued
      - status
    Interaction.LabSanitizer.ResultQuantitySanitizer:
      type: object
      properties:
        value:
          type: integer
          format: int32
          description: The measured value
        unit:
          type: string
          description: Unit of measure (e.g., "mg/dL")
      required:
      - value
      - unit
    Interaction.LabSanitizer.ActionSanitizer:
      type: object
      properties:
        reference:
          type: string
          description: Reference code for the test
        display:
          type: string
          description: Human-readable test name
      required:
      - reference
      - display
    Public.Interaction.FileBlueprint_leaf:
      type: object
      properties:
        id:
          type: string
        filename:
          type: string
    Interaction.LabSanitizer.ResultQuantitySanitizer_2:
      type: object
      properties:
        value:
          type: number
          format: float
          description: The measured value
        unit:
          type: string
          description: Unit of measure (e.g., "mg/dL")
      required:
      - value
      - unit
    Public.Interaction.LabBlueprint_one_2:
      type: object
      properties:
        id:
          type: string
        event_timestamp:
          type: string
          format: date-time
        patient_access:
          type: boolean
        status:
          type: string
        type:
          type: string
        vendor_order_id:
          type: string
        files:
          type: array
          items:
            $ref: '#/components/schemas/Public.Interaction.FileBlueprint_leaf'
        order:
          $ref: '#/components/schemas/Public.Interaction.Lab.OrderBlueprint_leaf'
        report:
          $ref: '#/components/schemas/Public.Interaction.Lab.ReportBlueprint_leaf'
        results:
          $ref: '#/components/schemas/Public.Interaction.Lab.ResultBlueprint_leaf'
    Public.Interaction.Lab.Result.QuantityBlueprint_leaf_2:
      type: object
      properties:
        value:
          type: number
          format: float
        unit:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Practice access token or Partner API key (Bearer authentication)
    hint_api_key:
      type: apiKey
      name: AUTHORIZATION
      in: header
      description: 'Enter your token in the format: `Bearer {your_api_key}`'
x-refined-from:
- hint-health-hint-health-api-openapi.yml
- hint-health-partner-endpoints-2026-07-01-openapi.yml