FHIR IG analytics| Package | tewhatuora.rheumaticfever |
| Resource Type | CapabilityStatement |
| Id | CapabilityStatement-RheumaticFeverCapabilityStatement.json |
| FHIR Version | R4 |
| Source | https://build.fhir.org/ig/tewhatuora/fhir-rheumatic-fever/CapabilityStatement-RheumaticFeverCapabilityStatement.html |
| URL | https://fhir-ig.digital.health.nz/rheumatic-fever/CapabilityStatement/RheumaticFeverCapabilityStatement |
| Version | 1.0.0 |
| Status | active |
| Date | 2024-06-14 |
| Name | RheumaticFeverAPICapabilityStatement |
| Title | Rheumatic Fever FHIR API Capability Statement |
| Authority | national |
| Description | New Zealand rheumatic fever FHIR API capability statement |
| Kind | instance |
No resources found
| StructureDefinition | |
| NzMedicationRequest | MedicationRequest resource for use in NZ |
| NzMedicationStatement | MedicationStatement resource for use in NZ |
| nz-rheumaticfever-careplan | Rheumatic Fever CarePlan |
| nz-rheumaticfever-careteam | Rheumatic Fever Care Team |
| nz-rheumaticfever-condition | Rheumatic Fever Condition |
| nz-rheumaticfever-diagnosisgroup | Rheumatic Fever Diagnosis Group |
| nz-rheumaticfever-medicationrequest | Rheumatic Fever Medication Request |
| nz-rheumaticfever-patient | Rheumatic Fever Patient |
Note: links and images are rebased to the (stated) source
Generated Narrative: CapabilityStatement RheumaticFeverCapabilityStatement
Profile: Capability Statement profile for use with the Health New Zealand Te Whatu Ora OpenAPI spec converter
jsonNote to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
serverSMART-on-FHIRtransactioninteraction described as follows:All HNZ FHIR API requests must include the health user and context of usage of the application making the API request.
This context is supplied using the 'Request-Context' custom header in the form of a base64-encoded JSON object.
Consumers of the Rheumatic Fever FHIR API must set the following properties in Request-Context
| Required context property | Attribute value |
|---|---|
userIdentifier |
The userid of the user as authenticated by RFCCS or the PMS/health application. |
purposeOfUse |
Set to "POPHEALTH" |
userFullName |
Display name of the user of RFCCS or the PMS/health application. |
hpiOrganisation |
The HPI Organisation identifier for the RF Secondary Prevention Service (aka Lead Provider) the user is affiliated with |
hpiPractitioner |
If available, the HPI Practitioner identifier (Common Person Number) of the user |
hpiFacility |
If available, the HPI Facility identifier of the health facility where the application is being used |
The schema for defining and validating these properties can be found here
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | The request was successful, and the response body contains the representation requested |
| 302 | FOUND | A common redirect response; you can GET the representation at the URI in the Location response header |
| 304 | NOT MODIFIED | Your client's cached version of the representation is still up to date |
| 401 | UNAUTHORIZED | The supplied credentials, if any, are not sufficient to access the resource |
| 404 | NOT FOUND | The requested representation was not found. Retrying this request is unlikely to be successful |
| 429 | TOO MANY REQUESTS | Your application is sending too many simultaneous requests |
| 500 | SERVER ERROR | An internal server error prevented return of the representation response |
| 503 | SERVICE UNAVAILABLE | We are temporarily unable to return the representation. Please wait and try again later |
| Code | Meaning | OperationOutcome in response? | Description |
|---|---|---|---|
| 200 | OK | Yes, when there are additional messages about a match result | The request was successful, and the response body contains the representation requested |
| 302 | FOUND | No | A common redirect response; you can GET the representation at the URI in the Location response header |
| 400 | BAD REQUEST | Yes | Incorrect search parameters or malformed request - see diagnostics in OperationOutcome |
| 401 | UNAUTHORIZED | The supplied credentials, if any, are not sufficient to access the resource | |
| 429 | TOO MANY REQUESTS | No | Your application is sending too many simultaneous requests |
| 500 | SERVER ERROR | No | An internal server error prevented return of the representation response |
| 503 | SERVICE UNAVAILABLE | No | The server is temporarily unable to return the representation. Please wait and try again later |
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | The request was successful, and the resource was updated. The response body contains the updated representation |
| 201 | CREATED | The request was successful, a new resource was created, and the response body contains the representation |
| 204 | OK - NO CONTENT | The request was successful, but no content is returned in the response. In reality this is seldom used for REST APIs and more typically for process APIs. Should include a Location header indicating the location of an associated relevant resource |
| 207 | MULTI STATUS | The HTTP 207 Multi-Status response code indicates that there might be a mixture of responses. |
| 400 | BAD REQUEST | The data given in the POST or PUT failed validation. Inspect the response body for details |
| 401 | UNAUTHORIZED | The supplied credentials, if any, are not sufficient to create or update the resource |
| 404 | NOT FOUND | The endpoint that the API Consumer is attempting to create or update does not exist. Retrying this request is unlikely to be successful |
| 405 | METHOD NOT ALLOWED | You can't POST or PUT to the resource |
| 422 | UNPROCESSABLE CONTENT | The server understands the requests content and syntax however it is unable to process the instruction. Retrying this request will not succeed - the request must be modified |
| 429 | TOO MANY REQUESTS | Your application is sending too many simultaneous requests |
| 500 | SERVER ERROR | We couldn't create or update the resource. Please try again later |
| Code | Meaning | Description |
|---|---|---|
| 204 | OK | The request was successful; the resource was deleted |
| 401 | UNAUTHORIZED | The supplied credentials, if any, are not sufficient to delete the resource |
| 404 | NOT FOUND | |
| 405 | METHOD NOT ALLOWED | You can't DELETE the resource |
| 429 | TOO MANY REQUESTS | Your application is sending too many simultaneous requests |
| 500 | SERVER ERROR | We couldn't delete the resource. Please try again later |
When a consumer attempts to call a non-existent API end point, respond with a 501 Not Implemented status code.
The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include_revinclude| Resource Type | Profile | R | V-R | S | U | C | D | Searches | _include | _revinclude | Operations |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Bundle | http://hl7.org/fhir/StructureDefinition/Bundle | y | y | y | y | y | y | patient, actor, status, date | * | ||
| CarePlan | https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-careplan | y | y | y | y | y | y | patient, status, subject, _profile, _id, category | *, CarePlan:encounter | ||
| CareTeam | Supported Profiles Rheumatic Fever Care Team | y | y | y | y | y | y | identifier, _profile, _id, category | |||
| Condition | https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-condition | y | y | y | y | y | y | patient, subject, _profile, _id, category | |||
| Consent | http://hl7.org/fhir/StructureDefinition/Consent | y | y | y | y | y | y | patient, data, source-reference, status, _id | *, Consent:source-reference | ||
| Encounter | http://hl7.org/fhir/StructureDefinition/Encounter | y | y | y | y | y | y | patient, status, subject, _id | *, Encounter:diagnosis | ||
| MedicationRequest | https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-medicationrequest Additional supported profiles: MedicationRequest resource for use in NZ | y | y | y | y | y | y | patient, status, medication | * | ||
| MedicationStatement | http://hl7.org/fhir/StructureDefinition/MedicationStatement Additional supported profiles: MedicationStatement resource for use in NZ | y | y | y | y | y | y | patient, status, medication | * | ||
| Observation | http://hl7.org/fhir/StructureDefinition/Observation Additional supported profiles: Rheumatic Fever Diagnosis Group | y | y | y | y | y | y | code, date, identifier, patient, based-on, encounter, category, derived-from, performer, status, subject, value-concept, value-date, value-quantity, value-string, _id, _lastUpdated | *, Observation:patient, Observation:encounter, Observation:based-on, Observation:derived-from, Observation:device, Observation:focus, Observation:has-member, Observation:part-of, Observation:performer, Observation:specimen, Observation:subject | ||
| Patient | https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-patient | y | y | y | y | y | y | identifier, _profile, _id | |||
| Questionnaire | y | y | y | y | y | y | identifier, name, status, title, url, _id | ||||
| QuestionnaireResponse | y | y | y | y | y | y | patient, questionnaire, status, subject, _id | *, QuestionnaireResponse:based-on, QuestionnaireResponse:encounter |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Who the sensitivity is for Patient |
| SHALL | actor | reference | Any one of the individuals participating in the appointment (Practitioner, Device, Patient, HealthcareService, PractitionerRole, RelatedPerson, Location) |
| SHALL | status | token | proposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlist |
| SHALL | date | date | Appointment date/time |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Who the care plan is for |
| SHALL | status | token | draft | active | on-hold | revoked | completed | entered-in-error | unknown |
| SHALL | subject | reference | Who the care plan is for |
| SHALL | _profile | reference | Filter RheumaticFeverCarePlan instances using the applicable profile canonical Url from IG |
| SHALL | _id | token | Logical id of this artifact |
| SHALL | category | token | Care plan search by category code. All rheumatic fever care plans are categorised #rf-nz |
create, read, update, delete, vread, search-type.This server supports one subtype of FHIR CareTeam - refer to Profiles
- RheumaticFeverCareTeam - simply requires use of particular Condition.category codes in rheumatic fever health applications
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | The patient's official NHI identifier |
| SHALL | _profile | reference | Filter RheumaticFeverCareTeam instances using the applicable profile canonical Url from IG |
| SHALL | _id | token | Logical id of this artifact |
| SHALL | category | token | Care team search by category code. All rheumatic fever care teams are categorised #rf-nz |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Who has the condition? |
| SHALL | subject | reference | Who has the condition? |
| SHALL | _profile | reference | Filter RheumaticFeverCondition instances using the applicable profile canonical Url from IG |
| SHALL | _id | token | Logical id of this artifact |
| SHALL | category | token | Condition search by category code. All rheumatic fever condtion instances have two category values (#rf-nz, SNOMED #58718002) |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Who the consent applies to |
| SHALL | data | reference | The actual data reference |
| SHALL | source-reference | reference | Search by reference to a Consent, DocumentReference, Contract or QuestionnaireResponse |
| SHALL | status | token | draft | proposed | active | rejected | inactive | entered-in-error |
| SHALL | _id | token | Logical id of this artifact |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | The patient or group present at the encounter |
| SHALL | status | token | planned | arrived | triaged | in-progress | onleave | finished | cancelled + |
| SHALL | subject | reference | The patient or group present at the encounter |
| SHALL | _id | token | Logical id of this artifact |
create, read, update, delete, vread, search-type.This server profiles NzMedicationRequest AND supports the NZ Base IG profile NzMedicationRequest.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | The rheumatic fever patient for whom this medication is prescribed |
| SHALL | status | token | active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown + |
| SHALL | medication | reference | Return all MedicationRequests that relate to this type of medication |
create, read, update, delete, vread, search-type.This server supports the NZ Base IG profiles NzMedicationStatement in addition to the base MedicationStatement FHIR resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | The rheumatic fever patient to whom medication was administered |
| SHALL | status | token | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken + |
| SHALL | medication | reference | Return all instances of administration of this medication |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | code | token | Describes what was observed. Sometimes this is called the observation 'name' |
| SHALL | date | date | Observation.effective Obtained date/time. If the obtained element is a period, a date that falls in the period |
| SHALL | identifier | token | A unique identifier assigned to this observation. |
| SHALL | patient | reference | Who the observation is for Patient |
| SHALL | based-on | reference | Reference to the service request. |
| SHALL | encounter | reference | The Encounter resource associated with the Observation. |
| SHALL | category | token | The classification of the type of observation |
| SHALL | derived-from | reference | Related measurements the observation is made from |
| SHALL | performer | reference | Who performed the observation |
| SHALL | status | token | The status of the observation |
| SHALL | subject | reference | The subject that the observation is about |
| SHALL | value-concept | token | The value of the observation, if the value is a CodeableConcept |
| SHALL | value-date | date | The value of the observation, if the value is a date or period of time |
| SHALL | value-quantity | quantity | The value of the observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data) |
| SHALL | value-string | string | The value of the observation, if the value is a string, and also searches in CodeableConcept.text |
| SHALL | _id | token | Logical id of this artifact |
| SHALL | _lastUpdated | date | When the resource version last changed |
create, read, update, delete, vread, search-type.This server supports one profile of FHIR Patient which is the rheumatic fever patient profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | The patient's official NHI identifier |
| SHALL | _profile | reference | Filter RheumaticFeverPatient instances using the applicable profile canonical Url from IG |
| SHALL | _id | token | Logical id of this artifact |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | External identifier for the questionnaire |
| SHALL | name | string | Computationally friendly name of the questionnaire |
| SHALL | status | token | The current status of the questionnaire |
| SHALL | title | string | The human-friendly name of the questionnaire |
| SHALL | url | uri | The uri that identifies the questionnaire |
| SHALL | _id | token | Logical id of this artifact |
create, read, update, delete, vread, search-type.| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | The patient that is the subject of the questionnaire response |
| SHALL | questionnaire | reference | The questionnaire the answers are provided for |
| SHALL | status | token | The status of the questionnaire response |
| SHALL | subject | reference | The subject of the questionnaire response |
| SHALL | _id | token | Logical id of this artifact |
{
"resourceType": "CapabilityStatement",
"id": "RheumaticFeverCapabilityStatement",
"meta": {
"profile": [
"https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/hnz-capability-statement"
]
},
"text": {
"status": "extensions",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"extension": [
{
"url": "licenseURL",
"valueUri": "https://www.tewhatuora.govt.nz/assets/Our-health-system/Digital-health/Digital-Service-Hub/API-Access-and-Use-Agreement.docx"
},
{
"url": "externalDocs",
"valueUri": "https://fhir-ig.digital.health.nz/rf"
},
{
"url": "licenseName",
"valueString": "Health New Zealand Digital Services Hub API Access and Use Agreement"
},
{
"extension": [
{
"extension": [
{
"url": "key",
"valueString": "Correlation-Id"
},
{
"url": "value",
"valueUri": "https://raw.githubusercontent.com/tewhatuora/schemas/main/shared-care/Correlation-Id.json"
},
{
"url": "required",
"valueBoolean": false
}
],
"url": "https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/custom-headers-extension"
},
{
"extension": [
{
"url": "key",
"valueString": "x-api-key"
},
{
"url": "value",
"valueUri": "https://raw.githubusercontent.com/tewhatuora/schemas/main/shared-care/Api-Key.json"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/custom-headers-extension"
},
{
"extension": [
{
"url": "key",
"valueString": "Request-Context"
},
{
"url": "value",
"valueUri": "https://raw.githubusercontent.com/tewhatuora/schemas/main/openapi-definitions/Request-Context.json"
},
{
"url": "required",
"valueBoolean": true
},
{
"url": "documentation",
"valueString": "A base64-encoded JSON object that defines the context of the current request.\nSee https://github.com/tewhatuora/schemas/blob/main/json-schema/Request-Context-v2.json for the schema this object must conform to."
}
],
"url": "https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/custom-headers-extension"
}
],
"url": "globalHeaders"
}
],
"url": "https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension"
}
],
"url": "https://fhir-ig.digital.health.nz/rheumatic-fever/CapabilityStatement/RheumaticFeverCapabilityStatement",
"version": "1.0.0",
"name": "RheumaticFeverAPICapabilityStatement",
"title": "Rheumatic Fever FHIR API Capability Statement",
"status": "active",
"date": "2024-06-14",
"publisher": "Te Whatu Ora",
"contact": [
{
"name": "Te Whatu Ora",
"telecom": [
{
"system": "url",
"value": "https://www.tewhatuora.govt.nz/"
},
{
"system": "email",
"value": "integration@tewhatuora.govt.nz"
}
]
},
{
"name": "HNZ Integration Team",
"telecom": [
{
"system": "email",
"value": "integration@tewhatuora.govt.nz",
"use": "work"
}
]
}
],
"description": "New Zealand rheumatic fever FHIR API capability statement",
"kind": "instance",
"implementation": {
"description": "NZ Rheumatic Fever FHIR API",
"url": "https://fhir.api.digital.health.nz/R4"
},
"fhirVersion": "4.0.1",
"format": [
"json"
],
"rest": [
{
"mode": "server",
"security": {
"extension": [
{
"extension": [
{
"url": "token",
"valueUri": "https://ppd.auth.services.health.nz/realms/hnz-integration/protocol/openid-connect/token"
}
],
"url": "http://fhir-registry.smarthealthit.org/StructureDefinition/oauth-uris"
},
{
"url": "http://fhir-registry.smarthealthit.org/StructureDefinition/capabilities",
"valueCode": "client-confidential-symmetric"
}
],
"cors": true,
"service": [
{
"coding": [
{
"code": "SMART-on-FHIR"
}
]
}
]
},
"resource": [
{
"type": "Bundle",
"profile": "http://hl7.org/fhir/StructureDefinition/Bundle",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "Who the sensitivity is for \n [Patient](http://hl7.org/fhir/R4/patient.html)"
},
{
"name": "actor",
"definition": "http://hl7.org/fhir/SearchParameter/Appointment-actor",
"type": "reference",
"documentation": "Any one of the individuals participating in the appointment (Practitioner, Device, Patient, HealthcareService, PractitionerRole, RelatedPerson, Location)"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Appointment-status",
"type": "token",
"documentation": "proposed | pending | booked | arrived | fulfilled | cancelled | noshow | entered-in-error | checked-in | waitlist"
},
{
"name": "date",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-date",
"type": "date",
"documentation": "Appointment date/time"
}
]
},
{
"type": "CarePlan",
"profile": "https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-careplan",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*",
"CarePlan:encounter"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "Who the care plan is for"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/CarePlan-status",
"type": "token",
"documentation": "draft | active | on-hold | revoked | completed | entered-in-error | unknown"
},
{
"name": "subject",
"definition": "http://hl7.org/fhir/SearchParameter/CarePlan-subject",
"type": "reference",
"documentation": "Who the care plan is for"
},
{
"name": "_profile",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Resource-profile",
"type": "reference",
"documentation": "Filter **RheumaticFeverCarePlan instances** using the applicable profile canonical Url from IG"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
},
{
"name": "category",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#CarePlan-category",
"type": "token",
"documentation": "Care plan search by category code. All rheumatic fever care plans are categorised #rf-nz"
}
]
},
{
"type": "CareTeam",
"supportedProfile": [
"https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-careteam"
],
"documentation": "\nThis server supports one subtype of FHIR CareTeam - refer to Profiles\n1. RheumaticFeverCareTeam - simply requires use of particular Condition.category codes in rheumatic fever health applications\n",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchParam": [
{
"name": "identifier",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Patient-identifier",
"type": "token",
"documentation": "The patient's official NHI identifier"
},
{
"name": "_profile",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Resource-profile",
"type": "reference",
"documentation": "Filter **RheumaticFeverCareTeam instances** using the applicable profile canonical Url from IG"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
},
{
"name": "category",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#CareTeam-category",
"type": "token",
"documentation": "Care team search by category code. All rheumatic fever care teams are categorised #rf-nz"
}
]
},
{
"type": "Condition",
"profile": "https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-condition",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "Who has the condition?"
},
{
"name": "subject",
"definition": "http://hl7.org/fhir/SearchParameter/Condition-subject",
"type": "reference",
"documentation": "Who has the condition?"
},
{
"name": "_profile",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Resource-profile",
"type": "reference",
"documentation": "Filter **RheumaticFeverCondition instances** using the applicable profile canonical Url from IG"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
},
{
"name": "category",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Condition-category",
"type": "token",
"documentation": "Condition search by category code. All rheumatic fever condtion instances have two category values (#rf-nz, SNOMED #58718002)"
}
]
},
{
"type": "Consent",
"profile": "http://hl7.org/fhir/StructureDefinition/Consent",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*",
"Consent:source-reference"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "Who the consent applies to"
},
{
"name": "data",
"definition": "http://hl7.org/fhir/SearchParameter/Consent-data",
"type": "reference",
"documentation": "The actual data reference"
},
{
"name": "source-reference",
"definition": "http://hl7.org/fhir/SearchParameter/Consent-source-reference",
"type": "reference",
"documentation": "Search by reference to a Consent, DocumentReference, Contract or QuestionnaireResponse"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Consent-status",
"type": "token",
"documentation": "draft | proposed | active | rejected | inactive | entered-in-error"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
}
]
},
{
"type": "Encounter",
"profile": "http://hl7.org/fhir/StructureDefinition/Encounter",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*",
"Encounter:diagnosis"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "The patient or group present at the encounter"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Encounter-status",
"type": "token",
"documentation": "planned | arrived | triaged | in-progress | onleave | finished | cancelled +"
},
{
"name": "subject",
"definition": "http://hl7.org/fhir/SearchParameter/Encounter-subject",
"type": "reference",
"documentation": "The patient or group present at the encounter"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
}
]
},
{
"type": "MedicationRequest",
"profile": "https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-medicationrequest",
"supportedProfile": [
"http://hl7.org.nz/fhir/StructureDefinition/NzMedicationRequest"
],
"documentation": "\nThis server profiles NzMedicationRequest AND supports the NZ Base IG profile NzMedicationRequest.\n",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "The rheumatic fever patient for whom this medication is prescribed"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Medication-status",
"type": "token",
"documentation": "active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown +"
},
{
"name": "medication",
"definition": "http://hl7.org/fhir/SearchParameter/medications-medication",
"type": "reference",
"documentation": "Return all MedicationRequests that relate to this type of medication"
}
]
},
{
"type": "MedicationStatement",
"profile": "http://hl7.org/fhir/StructureDefinition/MedicationStatement",
"supportedProfile": [
"http://hl7.org.nz/fhir/StructureDefinition/NzMedicationStatement"
],
"documentation": "\nThis server supports the NZ Base IG profiles NzMedicationStatement in addition to the base MedicationStatement FHIR resource.\n",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "The rheumatic fever patient to whom medication was administered"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Medication-status",
"type": "token",
"documentation": "active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken +"
},
{
"name": "medication",
"definition": "http://hl7.org/fhir/SearchParameter/medications-medication",
"type": "reference",
"documentation": "Return all instances of administration of this medication"
}
]
},
{
"type": "Observation",
"profile": "http://hl7.org/fhir/StructureDefinition/Observation",
"supportedProfile": [
"https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-diagnosisgroup"
],
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*",
"Observation:patient",
"Observation:encounter",
"Observation:based-on",
"Observation:derived-from",
"Observation:device",
"Observation:focus",
"Observation:has-member",
"Observation:part-of",
"Observation:performer",
"Observation:specimen",
"Observation:subject"
],
"searchParam": [
{
"name": "code",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-code",
"type": "token",
"documentation": "Describes what was observed. Sometimes this is called the observation 'name'"
},
{
"name": "date",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-date",
"type": "date",
"documentation": "Observation.effective \n Obtained date/time. If the obtained element is a period, a date that falls in the period"
},
{
"name": "identifier",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-identifier",
"type": "token",
"documentation": "A unique identifier assigned to this observation."
},
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-patient",
"type": "reference",
"documentation": "Who the observation is for \n [Patient](http://hl7.org/fhir/R4/patient.html)"
},
{
"name": "based-on",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-based-on",
"type": "reference",
"documentation": "Reference to the service request."
},
{
"name": "encounter",
"definition": "http://hl7.org/fhir/SearchParameter/clinical-encounter",
"type": "reference",
"documentation": "The Encounter resource associated with the Observation."
},
{
"name": "category",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-category",
"type": "token",
"documentation": "The classification of the type of observation"
},
{
"name": "derived-from",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-derived-from",
"type": "reference",
"documentation": "Related measurements the observation is made from"
},
{
"name": "performer",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-performer",
"type": "reference",
"documentation": "Who performed the observation"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-status",
"type": "token",
"documentation": "The status of the observation"
},
{
"name": "subject",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-subject",
"type": "reference",
"documentation": "The subject that the observation is about"
},
{
"name": "value-concept",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-value-concept",
"type": "token",
"documentation": "The value of the observation, if the value is a CodeableConcept"
},
{
"name": "value-date",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-value-date",
"type": "date",
"documentation": "The value of the observation, if the value is a date or period of time"
},
{
"name": "value-quantity",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-value-quantity",
"type": "quantity",
"documentation": "The value of the observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)"
},
{
"name": "value-string",
"definition": "http://hl7.org/fhir/SearchParameter/Observation-value-string",
"type": "string",
"documentation": "The value of the observation, if the value is a string, and also searches in CodeableConcept.text"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
},
{
"name": "_lastUpdated",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-lastUpdated",
"type": "date",
"documentation": "When the resource version last changed"
}
]
},
{
"type": "Patient",
"profile": "https://fhir-ig.digital.health.nz/rheumatic-fever/StructureDefinition/nz-rheumaticfever-patient",
"documentation": "\nThis server supports one profile of FHIR Patient which is the rheumatic fever patient profile\n",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchParam": [
{
"name": "identifier",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Patient-identifier",
"type": "token",
"documentation": "The patient's official NHI identifier"
},
{
"name": "_profile",
"definition": "https://hl7.org/fhir/searchparameter-registry.html#Resource-profile",
"type": "reference",
"documentation": "Filter **RheumaticFeverPatient instances** using the applicable profile canonical Url from IG"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
}
]
},
{
"type": "Questionnaire",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchParam": [
{
"name": "identifier",
"definition": "http://hl7.org/fhir/SearchParameter/Questionnaire-identifier",
"type": "token",
"documentation": "External identifier for the questionnaire"
},
{
"name": "name",
"definition": "http://hl7.org/fhir/SearchParameter/Questionnaire-name",
"type": "string",
"documentation": "Computationally friendly name of the questionnaire"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/Questionnaire-status",
"type": "token",
"documentation": "The current status of the questionnaire"
},
{
"name": "title",
"definition": "http://hl7.org/fhir/SearchParameter/Questionnaire-title",
"type": "string",
"documentation": "The human-friendly name of the questionnaire"
},
{
"name": "url",
"definition": "http://hl7.org/fhir/SearchParameter/Questionnaire-url",
"type": "uri",
"documentation": "The uri that identifies the questionnaire"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
}
]
},
{
"type": "QuestionnaireResponse",
"interaction": [
{
"code": "create"
},
{
"code": "read"
},
{
"code": "update"
},
{
"code": "delete"
},
{
"code": "vread"
},
{
"code": "search-type"
}
],
"versioning": "versioned",
"readHistory": false,
"updateCreate": false,
"conditionalCreate": false,
"conditionalRead": "not-supported",
"conditionalUpdate": false,
"conditionalDelete": "not-supported",
"searchInclude": [
"*",
"QuestionnaireResponse:based-on",
"QuestionnaireResponse:encounter"
],
"searchParam": [
{
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/QuestionnaireResponse-patient",
"type": "reference",
"documentation": "The patient that is the subject of the questionnaire response"
},
{
"name": "questionnaire",
"definition": "http://hl7.org/fhir/SearchParameter/QuestionnaireResponse-questionnaire",
"type": "reference",
"documentation": "The questionnaire the answers are provided for"
},
{
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/QuestionnaireResponse-status",
"type": "token",
"documentation": "The status of the questionnaire response"
},
{
"name": "subject",
"definition": "http://hl7.org/fhir/SearchParameter/QuestionnaireResponse-subject",
"type": "reference",
"documentation": "The subject of the questionnaire response"
},
{
"name": "_id",
"definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
"type": "token",
"documentation": "Logical id of this artifact"
}
]
}
],
"interaction": [
{
"code": "transaction",
"documentation": "### Request-Context custom header\n\nAll HNZ FHIR API requests must include the health user and context of usage of the application making the API request.\n\nThis context is supplied using the 'Request-Context' custom header in the form of a base64-encoded JSON object.\n\nConsumers of the Rheumatic Fever FHIR API must set the following properties in `Request-Context`\n\n|**Required context property**|**Attribute value**|\n|:------------------|:---------|\n| `userIdentifier` | The userid of the user as authenticated by RFCCS or the PMS/health application. |\n| `purposeOfUse` | Set to `\"POPHEALTH\"` |\n| `userFullName` | Display name of the user of RFCCS or the PMS/health application. |\n| `hpiOrganisation` | The HPI Organisation identifier for the RF Secondary Prevention Service (aka Lead Provider) the user is affiliated with |\n| `hpiPractitioner` | If available, the HPI Practitioner identifier (Common Person Number) of the user |\n| `hpiFacility` | If available, the HPI Facility identifier of the health facility where the application is being used |\n\nThe schema for defining and validating these properties can be [found here](https://github.com/tewhatuora/schemas/blob/main/json-schema/Request-Context-v2.json)\n\n\n### Error status codes\n\n#### Read (GET) Operation Statuses\n\n|**Code**|**Meaning**|**Description**|\n|:--:|:-----------------|:--|\n|200|OK |The request was successful, and the response body contains the representation requested|\n|302|FOUND |A common redirect response; you can GET the representation at the URI in the Location response header|\n|304|NOT MODIFIED |Your client's cached version of the representation is still up to date|\n|401|UNAUTHORIZED |The supplied credentials, if any, are not sufficient to access the resource|\n|404|NOT FOUND |The requested representation was not found. Retrying this request is unlikely to be successful|\n|429|TOO MANY REQUESTS |Your application is sending too many simultaneous requests|\n|500|SERVER ERROR |An internal server error prevented return of the representation response|\n|503|SERVICE UNAVAILABLE|We are temporarily unable to return the representation. Please wait and try again later|\n\n#### Search (GET) Operation Statuses\n\n|**Code**|**Meaning** |**OperationOutcome** in response?|**Description**|\n|:--:|:-----------------|:----------------------------------|:----------------------------------|\n|200|OK |Yes, when there are additional messages about a match result|The request was successful, and the response body contains the representation requested|\n|302|FOUND |No |A common redirect response; you can GET the representation at the URI in the Location response header|\n|400|BAD REQUEST |Yes|Incorrect search parameters or malformed request - see diagnostics in OperationOutcome|\n|401|UNAUTHORIZED |The supplied credentials, if any, are not sufficient to access the resource|\n|429|TOO MANY REQUESTS |No |Your application is sending too many simultaneous requests|\n|500|SERVER ERROR |No |An internal server error prevented return of the representation response|\n|503|SERVICE UNAVAILABLE|No |The server is temporarily unable to return the representation. Please wait and try again later|\n\n#### Create (POST or PUT) Operation Statuses\n\n|**Code**|**Meaning**|**Description**|\n|:--:|:-----------------|:--|\n|200|OK |The request was successful, and the resource was updated. The response body contains the updated representation|\n|201|CREATED |The request was successful, a new resource was created, and the response body contains the representation|\n|204|OK - NO CONTENT |The request was successful, but no content is returned in the response. In reality this is seldom used for REST APIs and more typically for process APIs. Should include a `Location` header indicating the location of an associated relevant resource|\n|207|MULTI STATUS |The HTTP 207 Multi-Status response code indicates that there might be a mixture of responses.|\n|400|BAD REQUEST |The data given in the POST or PUT failed validation. Inspect the response body for details|\n|401|UNAUTHORIZED |The supplied credentials, if any, are not sufficient to create or update the resource|\n|404|NOT FOUND |The endpoint that the API Consumer is attempting to create or update does not exist. Retrying this request is unlikely to be successful|\n|405|METHOD NOT ALLOWED |You can't POST or PUT to the resource|\n|422|UNPROCESSABLE CONTENT|The server understands the requests content and syntax however it is unable to process the instruction. Retrying this request will not succeed - the request must be modified|\n|429|TOO MANY REQUESTS |Your application is sending too many simultaneous requests|\n|500|SERVER ERROR |We couldn't create or update the resource. Please try again later|\n\n#### Delete (DELETE) Operation Statuses\n\n|**Code**|**Meaning**|**Description**|\n|:--:|:-----------------|:--|\n|204|OK |The request was successful; the resource was deleted|\n|401|UNAUTHORIZED |The supplied credentials, if any, are not sufficient to delete the resource|\n|404|NOT FOUND | |\n|405|METHOD NOT ALLOWED |You can't DELETE the resource|\n|429|TOO MANY REQUESTS |Your application is sending too many simultaneous requests|\n|500|SERVER ERROR |We couldn't delete the resource. Please try again later|\n\n\n### Non existent API endpoints\n\nWhen a consumer attempts to call a non-existent API end point, respond\nwith a **501 Not Implemented** status code."
}
]
}
]
}