v1

latestOpenAPI 3.0.0Apache 2.02026-07-143533191.6 KB
Booking

Delete or Cancel a Appointment resource by id

Delete or Cancel a single Appointment resource.

delete/Appointment/{id}

Path parameters

idstring uuid required
Example:91607239-b002-470a-8709-6b25bd50fdd1

The identifier of the resource.

Headers

X-Request-Idstring uuid required
Example:c1ab3fba-6bae-4ba4-b257-5a87c44d4a91

The X-Request-Id for the request header, when supplied, mirrored back by the receiver.

X-Correlation-Idstring uuid required
Example:9562466f-c982-4bd5-bb0e-255e9f5e6689

The X-Correlation-Id for the request header, when supplied, mirrored back by the receiver.

NHSD-Target-Identifierstring byte required

Identifier

Example:eyJzeXN0ZW0iOiJodHRwczovL2ZoaXIubmhzLnVrL0lkL2Rvcy1zZXJ2aWNlLWlkIiwidmFsdWUiOiIyMDAwMDExMTQ3In0=

The identifier of the Target system. A Base64 encoded object containing value and system properties. More information for this can be found in our implementation guidance.

Example object before encoding

{
  "value": "2000011147",
  "system": "https://fhir.nhs.uk/Id/dos-service-id"
}
NHSD-End-User-Organisationstring byte required

Requesting Organization described in an object based on a FHIR 'Organization' resource (Standard Base64 encoded JSON). Different BaRS Applications may have different standards and requirements for the Access Control which these headers are used for.

In this example an ODS code and the Organisation name is provided. Other identifiers are permitted if required.

Example:eyJyZXNvdXJjZVR5cGUiOiJPcmdhbml6YXRpb24iLCJpZGVudGlmaWVyIjpbeyJ2YWx1ZSI6IkExMDAxIiwic3lzdGVtIjoiaHR0cHM6Ly9maGlyLm5ocy51ay9JZC9vZHMtb3JnYW5pemF0aW9uLWNvZGUifV0sIm5hbWUiOiJNeSBzZXJ2aWNlIHByb3ZpZGVyIG5hbWUifQo=

Requesting Organization described in an object based on a FHIR 'Organization' resource (Standard Base64 encoded JSON). Different BaRS Applications may have different standards and requirements for the Access Control which these headers are used for. In the example given an ODS code and the Organisation name is provided. Other identifiers are permitted if required.

Example object before encoding

{
  "resourceType": "Organization",
  "identifier": [
    {
      "value": "A1001",
      "system": "https://fhir.nhs.uk/Id/ods-organization-code"
    }
  ],
  "name": "My service provider name"
}
NHSD-Requesting-Practitionerstring byte

Requesting Practitioner described in an object based on a FHIR 'PractitionerRole' resource (Standard Base64 encoded JSON).

This item is not mandatory, however if the information is available it must be included in the request. Only in the event that it is not available, should it be omitted.

The example below shows a General Practitioner and their SDS Role profile Id. The Base64 encoded example below shows a General Practitioner and their SDS Role profile Id.

Example:eyJyZXNvdXJjZVR5cGUiOiJzdHJpbmciLCJpZGVudGlmaWVyIjpbeyJ2YWx1ZSI6InN0cmluZyIsInN5c3RlbSI6InN0cmluZyJ9XSwiY29kZSI6W3siY29kaW5nIjpbeyJzeXN0ZW0iOiJzdHJpbmciLCJjb2RlIjoic3RyaW5nIiwiZGlzcGxheSI6InN0cmluZyJ9XX1dfQo=

Requesting Practitioner described in an object based on a FHIR 'PractitionerRole' resource (Standard Base64 encoded JSON).

This item is not mandatory, however if the information is available it must be included in the request. Only in the event that it is not available, should it be omitted.

The example given shows a General Practitioner and their SDS Role profile Id.

Example object before encoding

{
  "resourceType": "PractitionerRole",
  "identifier": [
    {
      "system": "https://fhir.nhs.uk/Id/sds-role-profile-id",
      "value": "100334993514"
    }
  ],
  "code": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "62247001",
          "display": "General practitioner"
        }
      ]
    }
  ]
}
NHSD-Requesting-Softwarestring byte required

Requesting Software described in an object based on a FHIR 'Device' resource (Standard Base64 encoded JSON). Different BaRS Applications may have different standards and requirements for the Access Control which these headers are used for.

The identifier used here, though arbitrary, should be consistent across instances of a product, the name and version of the product should also be accurate and consistent.

Example:eyJyZXNvdXJjZVR5cGUiOiJEZXZpY2UiLCJpZGVudGlmaWVyIjpbeyJzeXN0ZW0iOiJodHRwczovL2NvbnN1bWVyc3VwcGxpZXIuY29tL0lkL2RldmljZS1pZGVudGlmaWVyIiwidmFsdWUiOiJTVVBQLUFQUC0xIn1dLCJkZXZpY2VOYW1lIjp7Im5hbWUiOiJTdXBwbGllciBwcm9kdWN0IG5hbWUiLCJ0eXBlIjoibWFudWZhY3R1cmVyLW5hbWUifSwidmVyc2lvbiI6eyJ2YWx1ZSI6IjEuMC4wIn19Cg==

Requesting Software described in an object based on a FHIR 'Device' resource (Standard Base64 encoded JSON). Different BaRS Applications may have different standards and requirements for the Access Control which these headers are used for.

The identifier used, though arbitrary, should be consistent across instances of a product, the name and version of the product should also be accurate and consistent.

Example object before encoding

{
  "resourceType": "Device",
  "identifier": [
    {
      "system": "https://consumersupplier.com/Id/device-identifier",
      "value": "SUPP-APP-1"
    }
  ],
  "deviceName": {
    "name": "Supplier product name",
    "type": "manufacturer-name"
  },
  "version": {
    "value": "1.0.0"
  }
}
Acceptstring required
Example:application/fhir+json; version=1.4.0

The Accept header must also contain version of BaRS Core the Sender is expecting to interoperate on.

use-contextstring required
Example:a4t2|validation|servicerequest-response|new

This header is for usage statistics for the BaRS Proxy for NHS England.

Response

Successful response