Patient

Get count of patients for a specific HcParty or for the current HcParty

GET https://demo.icure.cloud/rest/v2/patient/hcParty/{hcPartyId}/count

Returns the count of patients

Path Parameters

NameTypeDescription

hcPartyId*

String

Healthcare party id

Create a patient

POST https://demo.icure.cloud/rest/v2/patient

Name, last name, date of birth, and gender are required. After creation of the patient and obtaining the ID, you need to create an initial delegation.

Request Body

NameTypeDescription

body*

Patient

Create patients in bulk

POST https://demo.icure.cloud/rest/v2/patient/batch

Returns the id and _rev of created patients

Request Body

NameTypeDescription

body*

List

Delete patients.

POST https://demo.icure.cloud/rest/v2/patient/delete/batch

Response is an array containing the ID of deleted patient..

Request Body

NameTypeDescription

body*

ListOfIds

Filter patients for the current user (HcParty)

POST https://demo.icure.cloud/rest/v2/patient/filter

Returns a list of patients along with next start keys and Document ID. If the nextStartKey is Null it means that this is the last page.

Query Parameters

NameTypeDescription

startKey

String

The start key for pagination, depends on the filters used

startDocumentId

String

A patient document ID

limit

Integer

Number of rows

skip

Integer

Skip rows

sort

String

Sort key

desc

Boolean

Descending

Request Body

NameTypeDescription

body*

FilterChainPatient

Find deleted patients

GET https://demo.icure.cloud/rest/v2/patient/deleted/byDate

Returns a list of deleted patients, within the specified time period, if any.

Query Parameters

NameTypeDescription

startDate

Long

Filter deletions after this date (unix epoch), included

endDate

Long

Filter deletions before this date (unix epoch), included

desc

Boolean

Descending

startDocumentId

String

A patient document ID

limit

Integer

Number of rows

Get Paginated List of Patients sorted by Access logs descending

GET https://demo.icure.cloud/rest/v2/patient/byAccess/{userId}

Path Parameters

NameTypeDescription

userId*

String

A User ID

Query Parameters

NameTypeDescription

accessType

String

The type of access (COMPUTER or USER)

startDate

Long

The start search epoch

startKey

String

The start key for pagination

startDocumentId

String

A patient document ID

limit

Integer

Number of rows

List patients for a specific HcParty

GET https://demo.icure.cloud/rest/v2/patient

Returns a list of patients along with next start keys and Document ID. If the nextStartKey is Null it means that this is the last page.

Query Parameters

NameTypeDescription

hcPartyId

String

Healthcare party id

sortField

String

Optional value for sorting results by a given field ('name', 'ssin', 'dateOfBirth'). Specifying this deactivates filtering

startKey

String

The start key for pagination: a JSON representation of an array containing all the necessary components to form the Complex Key's startKey

startDocumentId

String

A patient document ID

limit

Integer

Number of rows

sortDirection

String

Optional value for providing a sorting direction ('asc', 'desc'). Set to 'asc' by default.

Find patients for the current user (HcParty)

GET https://demo.icure.cloud/rest/v2/patient/byNameBirthSsinAuto

Returns a list of patients along with next start keys and Document ID. If the nextStartKey is Null it means that this is the last page.

Query Parameters

NameTypeDescription

healthcarePartyId

String

HealthcareParty Id, if unset will user user's hcpId

filterValue

String

Optional value for filtering results

startKey

String

The start key for pagination: a JSON representation of an array containing all the necessary components to form the Complex Key's startKey

startDocumentId

String

A patient document ID

limit

Integer

Number of rows

sortDirection

String

Optional value for providing a sorting direction ('asc', 'desc'). Set to 'asc' by default.

List patients by pages for a specific HcParty

GET https://demo.icure.cloud/rest/v2/patient/byHcPartyId

Returns a list of patients along with next start keys and Document ID. If the nextStartKey is Null it means that this is the last page.

Query Parameters

NameTypeDescription

hcPartyId*

String

Healthcare party id

startKey

String

The page first id

startDocumentId

String

A patient document ID

limit

Integer

Page size

List patients that have been modified after the provided date

GET https://demo.icure.cloud/rest/v2/patient/modifiedAfter/{date}

Returns a list of patients that have been modified after the provided date

Path Parameters

NameTypeDescription

date*

Long

Query Parameters

NameTypeDescription

startKey

Long

The start key for pagination the date of the first element of the new page

startDocumentId

String

A patient document ID

limit

Integer

Number of rows

Filter patients for the current user (HcParty)

GET https://demo.icure.cloud/rest/v2/patient/fuzzy

Returns a list of patients

Query Parameters

NameTypeDescription

firstName

String

The first name

lastName

String

The last name

dateOfBirth

Integer

The date of birth

Get patient

GET https://demo.icure.cloud/rest/v2/patient/{patientId}

It gets patient administrative data.

Path Parameters

NameTypeDescription

patientId*

String

Get the patient having the provided externalId

GET https://demo.icure.cloud/rest/v2/patient/byExternalId/{externalId}

Path Parameters

NameTypeDescription

externalId*

String

A external ID

Get patient by identifier

GET https://demo.icure.cloud/rest/v2/patient/{hcPartyId}/{id}

It gets patient administrative data based on the identifier (root & extension) parameters.

Path Parameters

NameTypeDescription

hcPartyId*

String

id*

String

Query Parameters

NameTypeDescription

system

String

Get the patient (identified by patientId) hcparty keys. Those keys are AES keys (encrypted) used to share information between HCPs and a patient.

GET https://demo.icure.cloud/rest/v2/patient/{patientId}/keys

This endpoint is used to recover all keys that have already been created and that can be used to share information with this patient. It returns a map with the following structure: ID of the owner of the encrypted AES key -> encrypted AES key. The returned encrypted AES keys will have to be decrypted using the patient's private key.

Path Parameters

NameTypeDescription

patientId*

String

The patient Id for which information is shared

Get patients by id

POST https://demo.icure.cloud/rest/v2/patient/byIds

It gets patient administrative data.

Request Body

NameTypeDescription

body*

ListOfIds

Find deleted patients

GET https://demo.icure.cloud/rest/v2/patient/deleted/by_name

Returns a list of deleted patients, by name and/or firstname prefix, if any.

Query Parameters

NameTypeDescription

firstName

String

First name prefix

lastName

String

Last name prefix

List patients that have been merged towards another patient

GET https://demo.icure.cloud/rest/v2/patient/merges/{date}

Returns a list of patients that have been merged after the provided date

Path Parameters

NameTypeDescription

date*

Long

Get ids of patients matching the provided filter for the current user (HcParty)

POST https://demo.icure.cloud/rest/v2/patient/match

Request Body

NameTypeDescription

body*

AbstractFilterPatient

Merge a series of patients into another patient

PUT https://demo.icure.cloud/rest/v2/patient/mergeInto/{toId}/from/{fromIds}

Path Parameters

NameTypeDescription

toId*

String

fromIds*

String

Modify a patient

PUT https://demo.icure.cloud/rest/v2/patient

No particular return value. It's just a message.

Request Body

NameTypeDescription

body*

Patient

Set a patient referral doctor

PUT https://demo.icure.cloud/rest/v2/patient/{patientId}/referral/{referralId}

Path Parameters

NameTypeDescription

patientId*

String

referralId*

String

The referal id. Accepts 'none' for referral removal.

Query Parameters

NameTypeDescription

start

Long

Optional value for start of referral

end

Long

Optional value for end of referral

Modify patients in bulk

PUT https://demo.icure.cloud/rest/v2/patient/batch

Returns the id and _rev of modified patients

Request Body

NameTypeDescription

body*

List

Delegates a patients to a healthcare party

POST https://demo.icure.cloud/rest/v2/patient/{patientId}/delegate

It delegates a patient to a healthcare party (By current healthcare party). A modified patient with new delegation gets returned.

Path Parameters

NameTypeDescription

patientId*

String

Request Body

NameTypeDescription

body*

List

Register a patient

POST https://demo.icure.cloud/rest/v2/patient/register/forHcp/{hcPartyId}/inGroup/{groupId}

Register a new patient into the system

Path Parameters

NameTypeDescription

hcPartyId*

String

groupId*

String

Request Body

NameTypeDescription

body*

Patient

undelete previously deleted patients

PUT https://demo.icure.cloud/rest/v2/patient/undelete/{patientIds}

Response is an array containing the ID of undeleted patient..

Path Parameters

NameTypeDescription

patientIds*

String

Last updated