Please wait...

Patient Vitals

By: Qymera


The Patient Vitals API offers a list of vital signs of a patient using his or her patient id.



Overview

  • The Patient Vitals API offers a list of vital signs of a patient using his or her patient id.
  • The API includes the site visit record and vital signs reporting in JSON format.
  • You can also get the current status of your patients.
Using the API

We built the API to be as self-documenting as possible, but if you find yourself overwhelmed, we organized this site into four major areas.

  • Getting started introduces you to the operations offered by the API.
  • API calls gives you a hands-on experience of those operations with an interactive console.

Getting Started

The current version of the API lives at https://gateway.qymera.tech/qymera/sb/patients/v1/.

  • https://gateway.qymera.tech/qymera/sb/patients/v1/vitals/envjcVAhuFtXhXNFIg1Dr-2-8diVcq3BOMcZpbjYOC7JAJ1pPzK0v1075T4XMHL.83
Endpoints
Endpoint What it does
/vitals/{patientId} This endpoint will get the vital signs of a patient based on their Patient ID.

API Calls

Headers
Key Value Description
accept application/json
x-ibm-client-id Use the given application credential id
x-ibm-client-secret Use the given application credential secret
Authorization Use the generated bearer token
/vitals
Implementation Notes

Get patient's vital signs using their patient ID

Parameters:
Parameter Data Type Necessity Location Description
patientId string required path Patient ID
Sample Request:
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/patients/v1/vitals/REPLACE_THIS_VALUE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
  --header 'Authorization: Bearer REPLACE_THIS_VALUE'
Request:

GET

https://gateway.qymera.tech/qymera/sb/patients/v1/vitals/envjcVAhuFtXhXNFIg1Dr-2-8diVcq3BOMcZpbjYOC7JAJ1pPzK0v1075T4XMHL.83

Response:

200

{
    "resourceType": "Observation",
    "id": "envjcVAhuFtXhXNFIg1Dr-2-8diVcq3BOMcZpbjYOC7JAJ1pPzK0v1075T4XMHL.83",
    "status": "final",
    "category": [
        {
            "coding": [
                {
                    "system": "http://terminology.hl7.org/CodeSystem/observation-category",
                    "code": "vital-signs",
                    "display": "Vital Signs"
                }
            ],
            "text": "Vital Signs"
        }
    ],
    "code": {
        "coding": [
            {
                "system": "urn:oid:1.2.840.114350.1.13.0.1.7.2.707679",
                "code": "5",
                "display": "BP"
            },
            {
                "system": "http://open.epic.com/FHIR/StructureDefinition/observation-flowsheet-id",
                "code": "tBdNYepLeojPG60x7nUx9kQ0",
                "display": "BP"
            },
            {
                "system": "urn:oid:1.2.246.537.6.96",
                "code": "8462-4"
            },
            {
                "system": "urn:oid:1.2.246.537.6.96",
                "code": "8480-6"
            },
            {
                "system": "http://loinc.org",
                "code": "55284-4",
                "display": "Blood pressure systolic and diastolic"
            },
            {
                "system": "http://loinc.org",
                "code": "85354-9",
                "display": "Blood pressure panel with all children optional"
            },
            {
                "system": "http://loinc.org",
                "code": "8716-3",
                "display": "Vital signs"
            }
        ],
        "text": "BP"
    },
    "subject": {
        "reference": "Patient/e63wRTbPfr1p8UW81d8Seiw3",
        "display": "Mychart, Theodore"
    },
    "encounter": {
        "reference": "Encounter/e8hBVXYLK9-otx9sWEP7xJQ3",
        "identifier": {
            "use": "usual",
            "system": "urn:oid:1.2.840.114350.1.13.0.1.7.3.698084.8",
            "value": "1875"
        },
        "display": "Office Visit"
    },
    "effectiveDateTime": "2010-06-12T17:20:00Z",
    "issued": "2010-06-12T17:20:27Z",
    "performer": [
        {
            "reference": "Practitioner/eU2bhJHhLPs8.VF8LzIGbIw3",
            "display": "Nurse Family Medicine, RN"
        }
    ],
    "component": [
        {
            "code": {
                "coding": [
                    {
                        "system": "http://loinc.org",
                        "code": "8480-6",
                        "display": "Systolic blood pressure"
                    }
                ],
                "text": "Systolic blood pressure"
            },
            "valueQuantity": {
                "value": 135,
                "unit": "mm[Hg]",
                "system": "http://unitsofmeasure.org",
                "code": "mm[Hg]"
            }
        },
        {
            "code": {
                "coding": [
                    {
                        "system": "http://loinc.org",
                        "code": "8462-4",
                        "display": "Diastolic blood pressure"
                    }
                ],
                "text": "Diastolic blood pressure"
            },
            "valueQuantity": {
                "value": 85,
                "unit": "mm[Hg]",
                "system": "http://unitsofmeasure.org",
                "code": "mm[Hg]"
            }
        }
    ]
}

404

{
    "code": -14,
    "message": "Something went wrong in getting patient data."
}