Patient read

get/Patient/{id}

Page View

This resource establishes demographics and identifiers for an individual visiting or receiving treatment from a healthcare organization. A patient record serves as the most common base for data being exchanged since it establishes the “who” behind the data.

You can review, retrieve, create, update, or match patient records.

Supported fields and schema examples

We support any valid FHIR® field. However, we only display fields we’ve defined in our schema, which are usually based on what’s included in the U.S. Core profile. We recommend relying on U.S. Core requirements.

Our schema examples show the shape and possibility of each FHIR® resource; they aren’t code for real-time API calls. We don’t currently recommend copying and pasting these schema examples for your API calls. Consider reviewing FHIR® API actions for realistic examples for particular use cases.

read

Review a specific Patient resource with details about a patient you're treating or interacting with.

FHIR read

To use a read interaction, you must know the related resource ID, which you may not have in your real workflows. A read is likely only a follow-up option after receiving the specific resource in a recent FHIR® passthrough or data on demand exchange.

Typically, you should use the more flexible _search with query parameters, unless you're guaranteed to request data directly from a FHIR® server using the resource ID. Learn more about using FHIR® identifiers.

Request parameters

cURL request example

bash

1
curl 'https://api.redoxengine.com/fhir/R4/{destinationSlug}/{environmentFlag}/Patient/{id}' \
2
--request GET \
3
--header 'Authorization: Bearer $API_TOKEN'

Request Parameters

id
required, string
Patient identifier

Response fields and example

json

1
{}

A profile on the patient resource that conforms to Redox requirements.

resourceType
required, string
Identifies the type of the resource
Value: Patient
identifier
required, Array of object
An identifier for this patient.
- system
  required, string
  Establishes the namespace for the value - that is, a URL that describes a set values that are unique.
- value
  required, string
  The portion of the identifier typically relevant to the user and which is unique within the context of the system.
- extension
  Array of Boolean, String, CodeableConcept, Coding
  May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
  One of:
  url
  required, string
  Source of the definition for the extension code - a logical name or a URL.
  valueBoolean
  boolean
  A single value for the extension.
- use
  string
  The purpose of this identifier.
  Possible Values: usual, official, temp, secondary, old (If known)
name
required, Array of object
A name associated with the individual.
- family
  string
  The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father.
- given
  Array of string
  Given name.
- use
  string
  Identifies the purpose for this name.
  Possible Values: usual, official, temp, nickname, anonymous, old, maiden
gender
required, string
Administrative Gender - the gender that the patient is considered to have for administration and record keeping purposes.
Possible Values: male, female, other, unknown
id
string
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
extension
Array of race, ethnicity, birthsex, patient-citizenship or Other
Additional information about patients not represented by standard FHIR fields.
active
boolean
Whether this patient record is in active use. Many systems use this property to mark as non-current patients, such as those that have not been seen for a period of time based on an organization's business rules.

It is often used to filter patient lists to exclude inactive patients

Deceased patients may also be marked as inactive for the same reasons, but may be active for some time after death.
telecom
Array of object
A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted.
- system
  required, string
  Telecommunications form for contact point - what communications system is required to make use of the contact.
  Possible Values: phone, fax, email, pager, url, sms, other
- value
  required, string
  The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address).
- use
  string
  Identifies the purpose for the contact point.
  Possible Values: home, work, temp, old, mobile
birthDate
string
The date of birth for the individual.
address
Array of object
An address for the individual.
- line
  Array of string
  This component contains the house number, apartment number, street name, street direction, P.O. Box number, delivery hints, and similar address information.
- city
  string
  The name of the city, town, suburb, village or other community or delivery center.
- state
  string
  Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).
- postalCode
  string
  A postal code designating a region defined by the postal service.
- period
  object
  Time period when address was/is in use.
  start
  string
  The start of the period. The boundary is inclusive.
  end
  string
  The end of the period. If the end of the period is missing, it means no end was known or planned at the time the instance was created. The start may be in the past, and the end date in the future, which means that period is expected/planned to end at that time.
- use
  string
  The purpose of this address.
  Possible Values: home, work, temp, old, billing
- district
  string
  The name of the administrative area (county).
- country
  string
  Country - a nation as commonly understood or generally accepted.
contact
Array of object
A contact party (e.g. guardian, partner, friend) for the patient.
- relationship
  Array of object
  The nature of the relationship between the patient and the contact.
  
  Redox sends and recognizes the following values for system:
  
  http://terminology.hl7.org/CodeSystem/v3-RoleCode - used as RelationToPatient
  
  http://terminology.hl7.org/CodeSystem/v2-0131 - used as the ContactRole
  
  coding
  Array of object
  A reference to a code defined by a terminology system.
  system
  string
  The identification of the code system that defines the meaning of the symbol in the code.
  code
  string
  A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
  text
  string
  A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
- name
  object
  A name associated with the contact person.
  use
  string
  Identifies the purpose for this name.
  Possible Values: usual, official, temp, nickname, anonymous, old, maiden
  family
  string
  The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father.
  given
  Array of string
  Given name.
- telecom
  Array of object
  A contact detail for the person, e.g. a telephone number or an email address.
  system
  string
  Telecommunications form for contact point - what communications system is required to make use of the contact.
  Possible Values: phone, fax, email, pager, url, sms, other
  value
  string
  The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address).
  use
  string
  Identifies the purpose for the contact point.
  Possible Values: home, work, temp, old, mobile
- address
  object
  Address for the contact person.
  use
  string
  The purpose of this address.
  Possible Values: home, work, temp, old, billing
  line
  Array of string
  This component contains the house number, apartment number, street name, street direction, P.O. Box number, delivery hints, and similar address information.
  city
  string
  The name of the city, town, suburb, village or other community or delivery center.
  district
  string
  The name of the administrative area (county).
  state
  string
  Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).
  postalCode
  string
  A postal code designating a region defined by the postal service.
  country
  string
  Country - a nation as commonly understood or generally accepted.
communication
Array of object
A language which may be used to communicate with the patient about his or her health.
- language
  required, object
  The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-EN" for England English.
  coding
  Array of object
  A reference to a code defined by a terminology system.
  system
  string
  The identification of the code system that defines the meaning of the symbol in the code.
  code
  string
  A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
  text
  string
  A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
generalPractitioner
Array of object
Patient's nominated care provider.

Must be a resource of type Practitioner.
- reference
  string
  A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with # and refers to a contained resource.
managingOrganization
object
Organization that is the custodian of the patient record.

Must be a resource of type Organization.
- reference
  string
  A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with # and refers to a contained resource.
link
Array of object
Link to another patient resource that concerns the same actual patient.
- other
  required, object
  The other patient resource that the link refers to.
  
  Must be a resource of type Patient.
  reference
  string
  A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with # and refers to a contained resource.
- type
  required, string
  The type of link between this patient resource and another patient resource.
  Possible Values: replaced-by, replaces
deceasedBoolean
boolean
Indicates if the individual is deceased or not.

Only one of deceasedBoolean, deceasedDateTime may be present.
deceasedDateTime
string
Indicates if the individual is deceased or not.

Only one of deceasedBoolean, deceasedDateTime may be present.

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.