Submit a condition

curl --request POST \
  --url https://api.clinikehr.com/v1/clinics/{clinic_id}/conditions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "code": "<string>",
  "clinical_status": "active",
  "onset_date": "2023-12-25",
  "resolved_date": "2023-12-25",
  "notes": "<string>",
  "client_reference": "<string>",
  "origin_assistant_name": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    patient_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    title: '<string>',
    code: '<string>',
    clinical_status: 'active',
    onset_date: '2023-12-25',
    resolved_date: '2023-12-25',
    notes: '<string>',
    client_reference: '<string>',
    origin_assistant_name: '<string>'
  })
};

fetch('https://api.clinikehr.com/v1/clinics/{clinic_id}/conditions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.clinikehr.com/v1/clinics/{clinic_id}/conditions"

payload = {
    "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "code": "<string>",
    "clinical_status": "active",
    "onset_date": "2023-12-25",
    "resolved_date": "2023-12-25",
    "notes": "<string>",
    "client_reference": "<string>",
    "origin_assistant_name": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "submission_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "resource_type": "condition",
    "action": "create",
    "review_status": "pending",
    "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "accepted_automatically": true,
    "source": "api",
    "submitted_at": "2023-11-07T05:31:56Z",
    "decided_at": "2023-11-07T05:31:56Z",
    "decision_reason": "<string>",
    "result_record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "client_reference": "<string>",
    "origin_assistant_name": "<string>",
    "payload": {}
  },
  "idempotent_replay": true
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

Conditions

Submit a condition

Permission: conditions:write

Submit a condition for a clinician to confirm.

The condition is held for review and answers 202 Accepted with a Location header pointing at the submission; it is not in the problem list until a clinician confirms it. The Idempotency-Key header is REQUIRED — a retry with the same key returns the original submission, never a second one. Send client_reference to tie the record to your own id. Also accepts a FHIR R4 Condition body (Content-Type: application/fhir+json).

POST

clinics

{clinic_id}

conditions

Submit a condition

curl --request POST \
  --url https://api.clinikehr.com/v1/clinics/{clinic_id}/conditions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "code": "<string>",
  "clinical_status": "active",
  "onset_date": "2023-12-25",
  "resolved_date": "2023-12-25",
  "notes": "<string>",
  "client_reference": "<string>",
  "origin_assistant_name": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    patient_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    title: '<string>',
    code: '<string>',
    clinical_status: 'active',
    onset_date: '2023-12-25',
    resolved_date: '2023-12-25',
    notes: '<string>',
    client_reference: '<string>',
    origin_assistant_name: '<string>'
  })
};

fetch('https://api.clinikehr.com/v1/clinics/{clinic_id}/conditions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.clinikehr.com/v1/clinics/{clinic_id}/conditions"

payload = {
    "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "code": "<string>",
    "clinical_status": "active",
    "onset_date": "2023-12-25",
    "resolved_date": "2023-12-25",
    "notes": "<string>",
    "client_reference": "<string>",
    "origin_assistant_name": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "submission_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "resource_type": "condition",
    "action": "create",
    "review_status": "pending",
    "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "accepted_automatically": true,
    "source": "api",
    "submitted_at": "2023-11-07T05:31:56Z",
    "decided_at": "2023-11-07T05:31:56Z",
    "decision_reason": "<string>",
    "result_record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "client_reference": "<string>",
    "origin_assistant_name": "<string>",
    "payload": {}
  },
  "idempotent_replay": true
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "code": "<string>",
  "request_id": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string

required

A unique value you choose for this request, such as a UUID. Sending the same key again returns the first answer instead of doing the work twice, so a timed-out request is safe to retry. Reusing a key for a different request is refused with 409 idempotency_key_conflict, and retrying while the first request is still running with 409 idempotency_key_reused. See Retries and idempotency.

Minimum string length: 1

Path Parameters

clinic_id

string<uuid>

required

Body

application/json

An outside condition, submitted for a clinician to confirm. It does not enter the problem list until then. code and code_system go together. client_reference (your own id for the record, up to 200 characters) makes a second submission of the same record with different content a client_reference_conflict.

patient_id

string<uuid>

required

title

string

required

Required string length: 1 - 500

code

string

code_system

enum<string>

Available options:

icd-10-cm,

icd-10,

snomed-ct,

local

clinical_status

enum<string>

default:active

Available options:

active,

resolved

onset_date

string<date>

resolved_date

string<date>

notes

string

Maximum string length: 4000

client_reference

string

Maximum string length: 200

origin_assistant_name

string

Maximum string length: 200

Response

Accepted — waiting for a clinician. If the clinic has chosen to accept this kind of item from your key or connection without review, the body already shows review_status: confirmed and accepted_automatically: true; read review_status, not the status code.

data

object

required

What the clinic's review queue holds for something this key sent: one outside record waiting for, or already past, a clinician's decision.

Show child attributes

idempotent_replay

boolean

Present and true when this Idempotency-Key was already used and the original submission is returned.

Overview

Your key

Connections

Patients

Appointments

Encounters

Notes

Conditions

Allergies

Medications

Referrals

Submissions

Providers

Care providers

Insurance payers

Insurance coverage

Inventory

Dispensing

Drug requests

Pharmacy listings

CRM

Events

FHIR

Submit a condition

Authorizations

Headers

Path Parameters

Body

Response