Clinical Genomic APIs for Oracle Healthcare Foundation

Retrieve Clinical Encounters for Patient Identifiers

get

/ohfapi/cg/v3.3/patientapi/encounters

This endpoint supports the retrieval of Clinical Encounters for multiple Patient Identifiers passed. It returns Clinical Encounter information like Type, Encounter Number, Location and other Clinical Encounter associated information.

Request

Supported Media Types

application/json
application/xml

Query Parameters

id: array

Collection Format: multi

Minimum Number of Items: 1

Maximum Number of Items: 2147483647

Patient Identifiers

[0]: integer(int64)

{
    "name":"id",
    "in":"query",
    "description":"Patient Identifiers",
    "required":true,
    "type":"array",
    "items":{
        "type":"integer",
        "format":"int64"
    },
    "collectionFormat":"multi",
    "maxItems":2147483647,
    "minItems":1
}

limit(optional): integer(int32)

Pagination query params: ?limit=2&offset=0
offset(optional): integer(int32)

Pagination query params: ?limit=2&offset=0

Security

basicAuth: basic

Type: basic

Response

Supported Media Types

application/json
application/xml

200 Response

successful operation

Model for paginated collections of data.

Root Schema : PageableCollectionClinicalEncounter

Type: object

Model for paginated collections of data.

Show Source

count(optional): integer(int64)

Number of objects in the 'items' collection.
hasMore(optional): boolean

Default Value: false

A boolean indicating if more pages are available.
items(optional): array items

A collection of paged items.
links(optional): array link

A collection of links containing hrefs to the current, next, and previous pages as applicable.
resourceType(optional): string

Identify the resource type

{
    "type":"object",
    "properties":{
        "resourceType":{
            "type":"string",
            "description":"Identify the resource type"
        },
        "items":{
            "type":"array",
            "xml":{
                "name":"items",
                "wrapped":true
            },
            "description":"A collection of paged items.",
            "items":{
                "$ref":"#/definitions/ClinicalEncounter"
            }
        },
        "count":{
            "type":"integer",
            "format":"int64",
            "description":"Number of objects in the 'items' collection."
        },
        "hasMore":{
            "type":"boolean",
            "description":"A boolean indicating if more pages are available.",
            "default":false
        },
        "links":{
            "type":"array",
            "example":"{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}",
            "xml":{
                "name":"link",
                "wrapped":true
            },
            "description":"A collection of links containing hrefs to the current, next, and previous pages as applicable.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Model for paginated collections of data."
}

Nested Schema : items

Type: array

A collection of paged items.

Show Source

Array of: object ClinicalEncounter

Model for a clinical encounter object in CDM.

{
    "type":"array",
    "xml":{
        "name":"items",
        "wrapped":true
    },
    "description":"A collection of paged items.",
    "items":{
        "$ref":"#/definitions/ClinicalEncounter"
    }
}

Nested Schema : link

Type: array

A collection of links containing hrefs to the current, next, and previous pages as applicable.

Show Source

Array of: string

{
    "type":"array",
    "example":"{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}",
    "xml":{
        "name":"link",
        "wrapped":true
    },
    "description":"A collection of links containing hrefs to the current, next, and previous pages as applicable.",
    "items":{
        "type":"string"
    }
}

Example:

{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}

Nested Schema : ClinicalEncounter

Type: object

Model for a clinical encounter object in CDM.

Show Source

encounterNumber(optional): string

Encounter Number
identifier(optional): object Identifier

Identifier assigned by a given system
location(optional): object Location
patient(optional): object LinkedReference
period(optional): object DateRange
type(optional): object CodeableConcept

Model that represents a value as a reference to one or more terminologies or ontologies or defined by the provision of text.

{
    "type":"object",
    "properties":{
        "identifier":{
            "description":"Clinical Encounter Identifier",
            "$ref":"#/definitions/Identifier"
        },
        "type":{
            "description":"CodeableConcept Details",
            "$ref":"#/definitions/CodeableConcept"
        },
        "location":{
            "description":"Location Details",
            "$ref":"#/definitions/Location"
        },
        "patient":{
            "example":"{href: '/patientapi/patients/{patientId}'}",
            "description":"A link containing href to retrieve Patient details",
            "$ref":"#/definitions/LinkedReference"
        },
        "period":{
            "description":"Patient Encounter Start Date and End Date Details",
            "$ref":"#/definitions/DateRange"
        },
        "encounterNumber":{
            "type":"string",
            "description":"Encounter Number"
        }
    },
    "description":"Model for a clinical encounter object in CDM."
}

Nested Schema : Identifier

Type: object

Identifier assigned by a given system

Show Source

system(optional): string

System which assigned this identifier
value(optional): string

Identifier value

{
    "type":"object",
    "properties":{
        "system":{
            "type":"string",
            "description":"System which assigned this identifier"
        },
        "value":{
            "type":"string",
            "description":"Identifier value"
        }
    },
    "description":"Identifier assigned by a given system"
}

Nested Schema : Location

Type: object

Show Source

identifier(optional): object CdmIdentifier

Identifier assigned by a given system
name(optional): string

Name of the facility.
type(optional): object CodeableConcept

Model that represents a value as a reference to one or more terminologies or ontologies or defined by the provision of text.

{
    "type":"object",
    "properties":{
        "identifier":{
            "$ref":"#/definitions/CdmIdentifier"
        },
        "name":{
            "type":"string",
            "description":"Name of the facility."
        },
        "type":{
            "$ref":"#/definitions/CodeableConcept"
        }
    }
}

Nested Schema : LinkedReference

Type: object

Show Source

display(optional): string
reference(optional): string

{
    "type":"object",
    "properties":{
        "reference":{
            "type":"string"
        },
        "display":{
            "type":"string"
        }
    }
}

Nested Schema : DateRange

Type: object

Show Source

end(optional): string(date-time)
start(optional): string(date-time)

{
    "type":"object",
    "properties":{
        "start":{
            "type":"string",
            "format":"date-time"
        },
        "end":{
            "type":"string",
            "format":"date-time"
        }
    }
}

Nested Schema : CodeableConcept

Type: object

Model that represents a value as a reference to one or more terminologies or ontologies or defined by the provision of text.

Show Source

coding(optional): array coding

Read Only: true

Code(s) defined by a terminology system.
text(optional): string

Plain text representation of the concept.

{
    "type":"object",
    "properties":{
        "text":{
            "type":"string",
            "description":"Plain text representation of the concept."
        },
        "coding":{
            "type":"array",
            "description":"Code(s) defined by a terminology system.",
            "readOnly":true,
            "items":{
                "$ref":"#/definitions/Coding"
            }
        }
    },
    "description":"Model that represents a value as a reference to one or more terminologies or ontologies or defined by the provision of text."
}

Nested Schema : CdmIdentifier

Type: object

Identifier assigned by a given system

Show Source

system(optional): string

System which assigned this identifier
value(optional): string

Identifier value

{
    "type":"object",
    "properties":{
        "system":{
            "type":"string",
            "description":"System which assigned this identifier"
        },
        "value":{
            "type":"string",
            "description":"Identifier value"
        }
    },
    "description":"Identifier assigned by a given system"
}

Nested Schema : coding

Type: array

Read Only: true

Code(s) defined by a terminology system.

Show Source

Array of: object Coding

Model for a reference to a code defined by a terminology system.

{
    "type":"array",
    "description":"Code(s) defined by a terminology system.",
    "readOnly":true,
    "items":{
        "$ref":"#/definitions/Coding"
    }
}

Nested Schema : Coding

Type: object

Model for a reference to a code defined by a terminology system.

Show Source

code(optional): string

Symbol in syntax defined by the system.
description(optional): string

Description defined by the system.
display(optional): string

Representation defined by the system.
sysId(optional): string

Identity of the terminology system.
sysName(optional): string

Name of the terminology system.
sysVersion(optional): string

Version of the system - if relevant.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Symbol in syntax defined by the system."
        },
        "display":{
            "type":"string",
            "description":"Representation defined by the system."
        },
        "description":{
            "type":"string",
            "description":"Description defined by the system."
        },
        "sysId":{
            "type":"string",
            "description":"Identity of the terminology system."
        },
        "sysName":{
            "type":"string",
            "description":"Name of the terminology system."
        },
        "sysVersion":{
            "type":"string",
            "description":"Version of the system - if relevant."
        }
    },
    "description":"Model for a reference to a code defined by a terminology system."
}

400 Response

Invalid parameters supplied

404 Response

encounter(s) not found

Examples

The following example submits a GET request.

API URL

http://localhost:7010/ohfapi/cg/v3.3/patientapi/encounters?id=1&id=2&limit=2&offset=0

Example of Response Body

The following example shows the contents of the response body in JSON format:

{
  "resourceType": "Encounter",
  "items": [
    {
      "identifier": {
        "system": "CDM",
        "value": "1"
      },
      "type": {
        "coding": [
          {
            "code": "1",
            "display": "ENC_TYPE1",
            "description": "ENC_TYPE_DESC1",
            "sysId": "EHA_CUSTOM_CD_SYS",
            "sysName": "EHA Custom Code System",
            "sysVersion": "1"
          }
        ]
      },
      "location": {
        "identifier": {
          "system": "CDM",
          "value": "1"
        },
        "name": "FAC1",
        "type": {
          "coding": [
            {
              "code": "FAC_SUBTYP_RM",
              "display": "Room",
              "description": "A space allocated for a function within a building or a floor",
              "sysId": "EHA_CUSTOM_CD_SYS",
              "sysName": "EHA Custom Code System",
              "sysVersion": "1"
            }
          ]
        }
      },
      "patient": {
        "reference": "/ohfapi/cg/v3.3/patientapi/patients/1"
      },
      "period": {
        "start": "01/01/1998",
        "end": "12/01/1998"
      },
      "encounterNumber": "ENC1"
    },
    {
      "identifier": {
        "system": "CDM",
        "value": "2"
      },
      "type": {
        "coding": [
          {
            "code": "1",
            "display": "ENC_TYPE1",
            "description": "ENC_TYPE_DESC1",
            "sysId": "EHA_CUSTOM_CD_SYS",
            "sysName": "EHA Custom Code System",
            "sysVersion": "1"
          }
        ]
      },
      "location": {
        "identifier": {
          "system": "CDM",
          "value": "1"
        },
        "name": "FAC1",
        "type": {
          "coding": [
            {
              "code": "FAC_SUBTYP_RM",
              "display": "Room",
              "description": "A space allocated for a function within a building or a floor",
              "sysId": "EHA_CUSTOM_CD_SYS",
              "sysName": "EHA Custom Code System",
              "sysVersion": "1"
            }
          ]
        }
      },
      "patient": {
        "reference": "/ohfapi/cg/v3.3/patientapi/patients/1"
      },
      "period": {
        "start": "01/01/1998",
        "end": "12/01/1998"
      },
      "encounterNumber": "ENC1"
    }
  ],
  "count": 2,
  "hasMore": true,
  "links": [
    {
      "rel": "self",
      "href": "http://localhost:7010/ohfapi/cg/v3.3/patientapi/encounters?id=1&id=2&limit=2&offset=0"
    },
    {
      "rel": "next",
      "href": "http://localhost:7010/ohfapi/cg/v3.3/patientapi/encounters?id=1&id=2&limit=2&offset=0"
    }
  ]
}