/rest/patients

post

{Protocol}://{Host}:{Port}/{Path}/rest/patients

Post a new patient record

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

external_id

string

The identifier given to the patient record by the user. This is usually an identifier generated by another tool, such as an EMR, and entered into PhenoTips to link back to help identify the patient.

labeled_eids

array of objects

An array that holds one or multiple labeled external identifiers.

labeled_eids

reporter

string

The user ID of the creator of the patient record. This user may no longer be responsible for or even have access to this patient record.

parental_names

object

sensitive_data

object

patient_tags

object

Contains tags associated with the patient.

contact

object

The contact information of the clinician responsible for a patient.

patient_address

object

The patient's address

patient_name

object

sex

string

F for female, M for male, O for other and U for unknown

clinical-diagnosis

array of objects

clinical-diagnosis

date_of_birth

object

May be a full or partial date

life_status

string

The supported options are alive, deceased, aborted, miscarriage, stillborn, unborn

date_of_death

object

May be a full or partial date

ethnicity

object

The ethnicities of the patient and/or the patient's parents. Their ethnicity/ethnicities should be stored as an array.

family_history

object

Information about the patient's family

global_mode_of_inheritance

array of objects

Marks the mode of inheritance of the majority of the patient’s disorders. If a patient has multiple disorders, the array could have multiple objects.

global_mode_of_inheritance

global_age_of_onset

array of objects

Marks the time when the majority of symptoms were first observed and is used in complement with the age_of_onset qualifier that can be optionally associated to each feature or disorder.

global_age_of_onset

prenatal_perinatal_history

object

Information related to the patient's prenatal and perinatal history

measurements

array of objects

An array of measurements taken on a patient. A date of birth is a prerequisite for calculating the percentiles and standard deviations.
This property requires PhenoTips version 7.17 or later.

measurements

apgar

object

The patient's APGAR scores at 1 and 5 minutes

genes

array of objects

The list of candidate, negative, rejected and confirmed causal solved genes. Each object in the list may have a gene name, status, strategy and a comments property.

genes

variants

array of objects

variants

number_variants

array of objects

An array of copy number variants

number_variants

clinicalStatus

string

The clinical status of the patient, which can be either affected or unaffected.

features

array of objects

A list of all phenotypes marked in the patient record.

features

nonstandard_features

array of objects

List of features that are not contained within the Human Phenotype Ontology, and were entered manually by the user.

nonstandard_features

disorders

array of objects

A list of all the disorders the patient has

disorders

allergies

array of strings

A list of all the environmental, food and drug allergies the patient has.

allergies

notes

object

All the note fields except resolution notes from the patient report are united under this section. Generally the name of the field indicates which section the notes are from.

solved

object

Case resolution

Responses

201

Creates a new patient record and returns its location

401

User not authenticated

403

User not authorized

500

Operation failed