GET [base]/[type]/[id]

One of the most basic interactions is used to obtain a resource by a given id. For more advanced options for getting resources, check out Search.

• 200 OK — resource successfully found and returned

• 404 Not Found — resource with a given id doesn't exist on the server

• 410 Gone — resource was deleted

200 OK

Get an existing patient:

GET /Patient/17b69d79-3d9b-45f8-af79-75f958502763

name:
- given: [Bob]
id: 17b69d79-3d9b-45f8-af79-75f958502763
resourceType: Patient
meta:
  lastUpdated: '2018-11-29T10:44:10.588Z'
  versionId: '13'
  tag:
  - {system: 'https://aidbox.app', code: created}

404 Not Found

Attempt to get a non-existing patient:

GET /Patient/some-not-existing-id

resourceType: OperationOutcome
status: 404
text: Resource Patient/some-not-existing-id not found

vread

GET [base]/[type]/[id]/_history/[vid]

This one is another read interaction, but it returns a specific version resource. Similar to read, but it additionally requires to specify version id.

200 OK

Version id 13 was extracted from the response of a create interaction.

GET /Patient/17b69d79-3d9b-45f8-af79-75f958502763/_history/13

name:
- given: [Bob]
id: 17b69d79-3d9b-45f8-af79-75f958502763
resourceType: Patient
meta:
  lastUpdated: '2018-11-29T10:44:10.588Z'
  versionId: '13'
  tag:
  - {system: 'https://aidbox.app', code: created}

​