Kno2

Kno2 provides Interoperability as a Service for healthcare - a single Communication API to SEND, RECEIVE, and FIND patient information across the healthcare ecosystem. One connection reaches Direct Secure Messaging, clinical document exchange, HL7 FHIR resources, HL7 V2.x, cloud fax, and national record location and retrieval through Kno2's private network, Carequality, eHealth Exchange, and TEFCA (Kno2 is a federally designated QHIN). API access is partner/enterprise gated - integrators are provisioned a per-subscription tenant host with OAuth2 client-credentials keys and an IP allowlist; a staging sandbox is available through the Kno2 Developer Program.

5 APIs 0 Features
Healthcare InteroperabilityClinical RecordsHealth Information ExchangeDirect Secure MessagingFHIRClinical DocumentsPatient RecordsHealthcareHIECare CoordinationQHINTEFCACarequality

APIs

Kno2 Messaging API

The core SEND surface. Request a draft message, populate it with the patient, recipient Direct address, document type, and metadata, attach one or more clinical documents (CCDA,...

Kno2 Intake and Retrieval API

The RECEIVE surface. Search the intake queue for inbound/processed messages awaiting EMR export, retrieve a message and its attachment metadata and content, mark attachments rea...

Kno2 Directory API

Validate Direct Secure Messaging addresses and endpoints before sending, and list the document types available to the current subscription. Confirmed endpoints api/directory/val...

Kno2 FHIR API

HL7 FHIR (DSTU3/R4) resource query and retrieval at scale, including USCDI data classes and patient demographic search, brokered through Kno2's gateway to Carequality and nation...

Kno2 Patient Record Query API

On-demand patient record location and retrieval across national networks - Kno2's private network, Carequality, eHealth Exchange, and TEFCA (Kno2 is a designated QHIN). Find a p...

Collections

Kno2 Communication API

OPEN

Pricing Plans

Kno2 Plans Pricing

2 plans

PLANS

Rate Limits

Kno2 Rate Limits

3 limits

RATE LIMITS

FinOps

Kno2 Finops

FINOPS

Resources

🔗
AgenticAccess
AgenticAccess
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Kno2 Communication API
  version: '1.0'
  description: Confirmed messaging surface of the Kno2 Communication API, grounded in Kno2's official Kno2.ApiTestClient.
    Base host is a per-integrator subscription tenant (https://{{subscription}}.kno2fy.com). OAuth2 client-credentials Bearer
    auth.
request:
  auth:
    type: bearer
    token: '{{accessToken}}'
items:
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Issue an access token
      type: http
    http:
      method: POST
      url: https://{{subscription}}.kno2fy.com/api/token
      auth:
        type: basic
        username: '{{clientId}}'
        password: '{{clientSecret}}'
      body:
        type: urlencoded
        data: grant_type=client_credentials
    docs: OAuth2 client-credentials token endpoint. HTTP Basic base64(clientId:clientSecret). Returns a Bearer access_token.
      CONFIRMED from ApiTestClient.
- info:
    name: Messaging (Send)
    type: folder
  items:
  - info:
      name: Request a draft message
      type: http
    http:
      method: PUT
      url: https://{{subscription}}.kno2fy.com/api/messages
    docs: Creates a new draft message and returns its id. CONFIRMED.
  - info:
      name: Populate / update a draft message
      type: http
    http:
      method: PUT
      url: https://{{subscription}}.kno2fy.com/api/messages/:id
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
      body:
        type: json
        data: '{}'
    docs: Populate the draft with patient, recipient Direct address, document type, and metadata. CONFIRMED.
  - info:
      name: Upload an attachment
      type: http
    http:
      method: POST
      url: https://{{subscription}}.kno2fy.com/api/messages/:id/attachments/:attachmentId
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
      - name: attachmentId
        value: ''
        type: path
        description: Attachment id.
      body:
        type: formdata
        data: ''
    docs: Uploads a clinical document (CCDA, PDF, image, HL7) as multipart/form-data. CONFIRMED.
  - info:
      name: Send a message
      type: http
    http:
      method: POST
      url: https://{{subscription}}.kno2fy.com/api/messages/:id/send
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
      body:
        type: json
        data: '{}'
    docs: Releases/sends the message over Direct Secure Messaging or document exchange. CONFIRMED.
- info:
    name: Intake (Receive / Find)
    type: folder
  items:
  - info:
      name: Search / find messages
      type: http
    http:
      method: GET
      url: https://{{subscription}}.kno2fy.com/api/messages?statuses=processed&processedtypes=AwaitingEMRExport&orderBy=updatedDate&orderDir=desc&pageSize=10&pageStart=1
    docs: Finds inbound messages awaiting EMR export (the RECEIVE / FIND queue). CONFIRMED.
  - info:
      name: Retrieve a message
      type: http
    http:
      method: GET
      url: https://{{subscription}}.kno2fy.com/api/messages/:id
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
    docs: Retrieves a single message by id. CONFIRMED.
  - info:
      name: Retrieve an attachment
      type: http
    http:
      method: GET
      url: https://{{subscription}}.kno2fy.com/api/messages/:id/attachments/:attachmentId
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
      - name: attachmentId
        value: ''
        type: path
        description: Attachment id.
    docs: Retrieves attachment metadata or binary content. CONFIRMED.
  - info:
      name: Mark an attachment read
      type: http
    http:
      method: PUT
      url: https://{{subscription}}.kno2fy.com/api/messages/:id/attachments/:attachmentId/read
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
      - name: attachmentId
        value: ''
        type: path
        description: Attachment id.
    docs: Records that an attachment has been read/consumed. CONFIRMED.
  - info:
      name: Process a message
      type: http
    http:
      method: POST
      url: https://{{subscription}}.kno2fy.com/api/messages/:id/process
      params:
      - name: id
        value: ''
        type: path
        description: Message id.
    docs: Marks a message as processed / records a read event. CONFIRMED.
- info:
    name: Directory
    type: folder
  items:
  - info:
      name: Validate Direct addresses
      type: http
    http:
      method: GET
      url: https://{{subscription}}.kno2fy.com/api/directory/validate?addresses=example@direct.kno2fy.com
    docs: Validates one or more Direct Secure Messaging addresses. CONFIRMED.
  - info:
      name: List document types
      type: http
    http:
      method: GET
      url: https://{{subscription}}.kno2fy.com/api/documenttypes
    docs: Lists document types available to the subscription. CONFIRMED.