Jump to

• Request
• Response
• Examples

Retrieve History for Patients

get

/ohfapi/cg/v3.3/patientapi/patients/history

This endpoint supports the retrieval of Histories for multiple Patient Record (row) ids passed. It returns History related information like Code, Category and other 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

Back to Top

Response

Supported Media Types

• application/json
• application/xml

200 Response

successful operation

Body ()

Root Schema : PageableCollectionHistory

Type: object

Model for paginated collections of data.

Show Source

• count(optional): integer(int64)
  Number of objects in the 'items' collection.
• hasMore(optional): boolean
  A boolean indicating if more pages are available.
• items(optional): array items
  A collection of paged items.
• links(optional): array links
  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":{
                "wrapped":true
            },
            "description":"A collection of paged items.",
            "items":{
                "$ref":"#/definitions/History"
            }
        },
        "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."
        },
        "links":{
            "type":"array",
            "example":"{rel: 'next',href: '/patientapi/patients?limit=100&offset=300'}",
            "xml":{
                "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 History

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

Nested Schema : links

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":{
        "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 : History

Type: object

Show Source

• amount(optional): object Quantity
  Model for a Quantity object in CDM.
• category(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.
• code(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.
• endDate(optional): string(date-time)
  History End Date
• familyMemberRelationshipTypeCode(optional): object FamilyMemberRelationshipType
• frequency(optional): object Quantity
  Model for a Quantity object in CDM.
• identifier(optional): object Identifier
  Identifier assigned by a given system
• lastExperienceDateTime(optional): string(date-time)
  History Last Experienced Date
• onsetDateTime(optional): string(date-time)
  History Onset Date
• patient(optional): object LinkedReference
• period(optional): object DateRange
• resolutionDateTime(optional): string(date-time)
  History Resolution Date
• startDate(optional): string(date-time)
  History Start Date
• subject(optional): object LinkedReference
• valueCode(optional): object ValueCode
• valueDateTime(optional): string(date-time)
  History Value Date

{
    "type":"object",
    "properties":{
        "identifier":{
            "description":"History Identifier",
            "$ref":"#/definitions/Identifier"
        },
        "code":{
            "description":"Code CodeableConcept Details",
            "$ref":"#/definitions/CodeableConcept"
        },
        "category":{
            "description":"Category CodeableConcept Details",
            "$ref":"#/definitions/CodeableConcept"
        },
        "startDate":{
            "type":"string",
            "format":"date-time",
            "description":"History Start Date"
        },
        "endDate":{
            "type":"string",
            "format":"date-time",
            "description":"History End Date"
        },
        "onsetDateTime":{
            "type":"string",
            "format":"date-time",
            "description":"History Onset Date"
        },
        "resolutionDateTime":{
            "type":"string",
            "format":"date-time",
            "description":"History Resolution Date"
        },
        "lastExperienceDateTime":{
            "type":"string",
            "format":"date-time",
            "description":"History Last Experienced Date"
        },
        "amount":{
            "description":"Amount",
            "$ref":"#/definitions/Quantity"
        },
        "frequency":{
            "description":"Frequency",
            "$ref":"#/definitions/Quantity"
        },
        "valueCode":{
            "description":"Value Code",
            "$ref":"#/definitions/ValueCode"
        },
        "valueDateTime":{
            "type":"string",
            "format":"date-time",
            "description":"History Value Date"
        },
        "familyMemberRelationshipTypeCode":{
            "$ref":"#/definitions/FamilyMemberRelationshipType"
        },
        "period":{
            "description":"Start Date and End Date Details",
            "$ref":"#/definitions/DateRange"
        },
        "subject":{
            "example":"{href: '/subjectapi/subjects/{subjectId}'}",
            "description":"A link containing href to retrieve Subject details",
            "$ref":"#/definitions/LinkedReference"
        },
        "patient":{
            "example":"{href: '/patientapi/patients/{patientId}'}",
            "description":"A link containing href to retrieve Patient details",
            "$ref":"#/definitions/LinkedReference"
        }
    }
}

Nested Schema : Quantity

Type: object

Model for a Quantity object in CDM.

Show Source

• code(optional): string
  The quantity units symbol in syntax defined by the system.
• description(optional): string
  The quantity units description.
• sysId(optional): string
  The quantity units terminology system identifier.
• sysName(optional): string
  The quantity units terminology system name.
• sysVersion(optional): string
  The quantity units terminology system version.
• units(optional): string
  The quantity units displayable name.
• value(optional): string
  The numerical value of the quantity.

{
    "type":"object",
    "properties":{
        "value":{
            "type":"string",
            "description":"The numerical value of the quantity."
        },
        "units":{
            "type":"string",
            "description":"The quantity units displayable name."
        },
        "code":{
            "type":"string",
            "description":"The quantity units symbol in syntax defined by the system."
        },
        "description":{
            "type":"string",
            "description":"The quantity units description."
        },
        "sysId":{
            "type":"string",
            "description":"The quantity units terminology system identifier."
        },
        "sysName":{
            "type":"string",
            "description":"The quantity units terminology system name."
        },
        "sysVersion":{
            "type":"string",
            "description":"The quantity units terminology system version."
        }
    },
    "description":"Model for a Quantity object in CDM."
}

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":{
                "xml":{
                    "name":"coding"
                },
                "$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 : FamilyMemberRelationshipType

Type: object

Show Source

• identifier(optional): object CdmIdentifier
  Identifier assigned by a given system
• 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":"Identifier",
            "$ref":"#/definitions/CdmIdentifier"
        },
        "type":{
            "description":"CodeableConcept details",
            "$ref":"#/definitions/CodeableConcept"
        }
    }
}

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 : 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 : ValueCode

Type: object

Show Source

• identifier(optional): object CdmIdentifier
  Identifier assigned by a given system
• value(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":"Value Code Identifier",
            "$ref":"#/definitions/CdmIdentifier"
        },
        "value":{
            "description":"CodeableConcept Details",
            "$ref":"#/definitions/CodeableConcept"
        }
    }
}

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":{
        "xml":{
            "name":"coding"
        },
        "$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.
• srvcProviderId(optional): string
  Service Provider Id of Specimen Alias .
• srvcProviderName(optional): string
  Service Provider Name of Specimen Alias .
• 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."
        },
        "srvcProviderId":{
            "type":"string",
            "description":"Service Provider Id of Specimen Alias ."
        },
        "srvcProviderName":{
            "type":"string",
            "description":"Service Provider Name of Specimen Alias ."
        }
    },
    "description":"Model for a reference to a code defined by a terminology system."
}

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"
}

400 Response

Invalid parameters supplied

404 Response

historys not found

Back to Top

Examples

The following example submits a GET request.

API URL

http://localhost:7010/ohfapi/cg/v3.3/patientapi/patients/history?id=79&id=80

Example of Response Body

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

{
  "resourceType": "History",
  "items": [
    {
      "identifier": {
        "system": "CDM",
        "value": "1"
      },
      "code": {
        "coding": [
          {
            "code": "9469",
            "display": "PH9469"
          }
        ]
      },
      "category": {
        "coding": [
          {
            "code": "PHTYPCD9469",
            "display": "PHTYPNM9469"
          }
        ]
      },
      "amount": {
        "units": "UOM1",
        "code": "1"
      },
      "frequency": {
        "units": "UOM1",
        "code": "1"
      },
      "period": {
        "start": "02/11/2026",
        "end": "03/03/2026"
      },
      "patient": {
        "reference": "/ohfapi/cg/v3.3/patientapi/patients/79"
      }
    },
    {
      "identifier": {
        "system": "CDM",
        "value": "2"
      },
      "code": {
        "coding": [
          {
            "code": "6865",
            "display": "PH6865"
          }
        ]
      },
      "category": {
        "coding": [
          {
            "code": "PHTYPCD6865",
            "display": "PHTYPNM6865"
          }
        ]
      },
      "frequency": {
        "units": "UOM1",
        "code": "1"
      },
      "period": {
        "start": "11/26/1976",
        "end": "12/16/1976"
      },
      "patient": {
        "reference": "/ohfapi/cg/v3.3/patientapi/patients/80"
      }
    }
  ],
  "count": 2,
  "hasMore": false,
  "links": [
    {
      "rel": "self",
      "href": "http://localhost:7010/ohfapi/cg/v3.3/patientapi/patients/history?id=79&id=80"
    }
  ]
}

Back to Top