05 · Treat

Server

Calls made at Treat. Taught at /rail/stops/Treat.

Search ICD-11 for a codable diagnosis. The picker is fetched, never typed.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v2/clinical/diagnoses

Search ICD-11 for a codable diagnosis. The picker is fetched, never typed.

Not implemented yet. Not registered. The live coded-list surface is /api/v1/terminology — /concepts, /concepts/{concept_id} and /value-sets — which is where an ICD-11 search will resolve from.

Keep from the response: codes[].code

Taught in: 05 · Treat

Search ICD-11 for a codable diagnosis. The picker is fetched, never typed. › query Parameters

version

string · required

version

q

string · required

diagnosis query

Search ICD-11 for a codable diagnosis. The picker is fetched, never typed. › Headers

X-Facility-Id

string · required

The facility this call is made from.

X-Facility-Id-Type

string · required

How to read X-Facility-Id: mfl, license-number, fr-code, registration-number or fid.

Search ICD-11 for a codable diagnosis. The picker is fetched, never typed. › Responses

200

Returns codes[].code.

value_set

string

version

string

object[]

Record a diagnosis on the visit's clinical record — a Condition on the encounter. A clinical fact first; no cover appears here.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v2/visits/{visit_ref}/diagnoses

Record a diagnosis on the visit's clinical record — a Condition on the encounter. A clinical fact first; no cover appears here.

Keep from the response: diagnosis_ref

Taught in: 05 · Treat

Record a diagnosis on the visit's clinical record — a Condition on the encounter. A clinical fact first; no cover appears here. › path Parameters

visit_ref

string · required

visit ref

Record a diagnosis on the visit's clinical record — a Condition on the encounter. A clinical fact first; no cover appears here. › Request Body

system

string

code

string

role

string

Record a diagnosis on the visit's clinical record — a Condition on the encounter. A clinical fact first; no cover appears here. › Responses

200

Returns diagnosis_ref.

No data returned

Every diagnosis on this visit, and which intervention each one supports.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/diagnoses

Every diagnosis on this visit, and which intervention each one supports.

Not implemented yet. No diagnosis routes under a v1 visit. Writing one is live at POST /api/v2/visits/{visit_ref}/diagnoses; reading them back and withdrawing one are not.

Keep from the response: diagnoses[].diagnosis_id

Taught in: 05 · Treat

Every diagnosis on this visit, and which intervention each one supports. › path Parameters

visit_id

string · required

visit id

Every diagnosis on this visit, and which intervention each one supports. › Responses

200

Returns diagnoses[].diagnosis_id.

No data returned

Withdraw a diagnosis recorded in error. Refused once the claim is submitted.

DELETE

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/diagnoses/{diagnosis_id}

Withdraw a diagnosis recorded in error. Refused once the claim is submitted.

Not implemented yet. No diagnosis routes under a v1 visit. The nearest registered withdrawal is PATCH /api/v1/claims/diagnoses, which acts on a claim rather than on a visit.

Keep from the response: status

Taught in: 05 · Treat

Withdraw a diagnosis recorded in error. Refused once the claim is submitted. › path Parameters

visit_id

string · required

visit id

diagnosis_id

string · required

diagnosis id

Withdraw a diagnosis recorded in error. Refused once the claim is submitted. › Responses

200

Returns status.

No data returned

Read back what this visit has written — the encounter and every resource under it.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/clinical

Read back what this visit has written — the encounter and every resource under it.

Not implemented yet. Same route as clinical.contribute, and equally unregistered. GET /api/v2/visits/{visit_ref}/documents reads what is attached to a visit; it is not a clinical read.

Keep from the response: resources[].id

Taught in: 05 · Treat

Read back what this visit has written — the encounter and every resource under it. › path Parameters

visit_id

string · required

visit id

Read back what this visit has written — the encounter and every resource under it. › Responses

200

Returns resources[].id.

No data returned

Contribute the encounter to the shared health record as a FHIR bundle.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/clinical

Contribute the encounter to the shared health record as a FHIR bundle.

Not implemented yet. There is no /clinical child under a visit, and the registered visits group is v2, not v1. The nearest live calls are POST /api/v2/visits/{visit_ref}/diagnoses and the /api/v1/shr group — neither is a drop-in.

Keep from the response: bundle_id

Taught in: 05 · Treat

Contribute the encounter to the shared health record as a FHIR bundle. › path Parameters

visit_id

string · required

visit id

Contribute the encounter to the shared health record as a FHIR bundle. › Request Body

resource_type

string

type

string

object[]

Contribute the encounter to the shared health record as a FHIR bundle. › Responses

200

Returns bundle_id.

bundle_id

string

status

string

object[]

POST/api/v1/visits/{visit_id}/clinical

curl https://api-dev.slade360edi.com/orchestrator/api/v1/visits/:visit_id/clinical \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "resource_type": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "resource": {
        "resourceType": "Encounter",
        "status": "in-progress",
        "class": {
          "code": "AMB",
          "display": "outpatient"
        }
      }
    },
    {
      "resource": {
        "resourceType": "Condition",
        "code": {
          "coding": [
            {
              "system": "http://id.who.int/icd/release/11/mms",
              "code": "1F41"
            }
          ]
        }
      }
    },
    {
      "resource": {
        "resourceType": "Observation",
        "code": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "8310-5"
            }
          ]
        },
        "valueQuantity": {
          "value": 38.9,
          "unit": "Cel"
        }
      }
    }
  ]
}'

Example Request Body

{
  "resource_type": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "resource": {
        "resourceType": "Encounter",
        "status": "in-progress",
        "class": {
          "code": "AMB",
          "display": "outpatient"
        }
      }
    },
    {
      "resource": {
        "resourceType": "Condition",
        "code": {
          "coding": [
            {
              "system": "http://id.who.int/icd/release/11/mms",
              "code": "1F41"
            }
          ]
        }
      }
    },
    {
      "resource": {
        "resourceType": "Observation",
        "code": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "8310-5"
            }
          ]
        },
        "valueQuantity": {
          "value": 38.9,
          "unit": "Cel"
        }
      }
    }
  ]
}

json

application/json

Example Responses

{
  "bundle_id": "BDL-2026-08-14-004417",
  "status": "written",
  "resources": [
    {
      "resourceType": "Encounter",
      "id": "enc-9d21",
      "status": "written"
    },
    {
      "resourceType": "Condition",
      "id": "con-4a77",
      "status": "written"
    },
    {
      "resourceType": "Observation",
      "id": "obs-11c3",
      "status": "written"
    }
  ]
}

json

application/json

The episodes of care this patient has open — the thread visits hang from.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/clinical/episodes-of-care

The episodes of care this patient has open — the thread visits hang from.

Keep from the response: episode_id

Taught in: 05 · Treat

The episodes of care this patient has open — the thread visits hang from. › Responses

200

Returns episode_id.

object[]

Open an episode, or attach this visit to one that is already running.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/clinical/episodes-of-care

Open an episode, or attach this visit to one that is already running.

Keep from the response: episode_id

Taught in: 05 · Treat

Open an episode, or attach this visit to one that is already running. › Request Body

unique_patient_id

string

visit_id

string

object

intent

string

Open an episode, or attach this visit to one that is already running. › Responses

200

Returns episode_id.

No data returned

Order a lab, an image or a procedure. Routed to the performer, whether or not it is you.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/orders

Order a lab, an image or a procedure. Routed to the performer, whether or not it is you.

Not implemented yet. No /orders prefix exists under either version, and no orders domain in the service.

Keep from the response: order_id

Taught in: 05 · Treat

Order a lab, an image or a procedure. Routed to the performer, whether or not it is you. › path Parameters

visit_id

string · required

visit id

Order a lab, an image or a procedure. Routed to the performer, whether or not it is you. › Request Body

category

string

object

priority

string

object[]

object

performer_facility

string

object

Order a lab, an image or a procedure. Routed to the performer, whether or not it is you. › Responses

200

Returns order_id.

order_id

string

status

string

performer_facility

string

object[]

POST/api/v1/visits/{visit_id}/orders

curl https://api-dev.slade360edi.com/orchestrator/api/v1/visits/:visit_id/orders \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "category": "laboratory",
  "code": {
    "system": "LOINC",
    "code": "24312-6",
    "display": "MRI Knee"
  },
  "priority": "routine",
  "reason": [
    {
      "icd11_code": "1F41"
    }
  ],
  "requester": {
    "hwr_number": "{{hwr_number}}"
  },
  "performer_facility": "{{facility_code}}",
  "specimen": {
    "type": "BLD",
    "collected_at": "2026-08-14T09:12:00+03:00"
  }
}'

Example Request Body

{
  "category": "laboratory",
  "code": {
    "system": "LOINC",
    "code": "24312-6",
    "display": "MRI Knee"
  },
  "priority": "routine",
  "reason": [
    {
      "icd11_code": "1F41"
    }
  ],
  "requester": {
    "hwr_number": "{{hwr_number}}"
  },
  "performer_facility": "{{facility_code}}",
  "specimen": {
    "type": "BLD",
    "collected_at": "2026-08-14T09:12:00+03:00"
  }
}

json

application/json

Example Responses

{
  "order_id": "ORD-2026-08-14-002215",
  "status": "routed",
  "performer_facility": "FR-14082",
  "expanded_parameters": [
    {
      "code": "718-7",
      "display": "Haemoglobin"
    },
    {
      "code": "789-8",
      "display": "Erythrocytes"
    }
  ]
}

json

application/json

Orders routed to this facility from anywhere on the rail — your work queue.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/orders

Orders routed to this facility from anywhere on the rail — your work queue.

Not implemented yet. No /orders prefix exists under either version.

Keep from the response: orders[].order_id

Taught in: 05 · Treat

Orders routed to this facility from anywhere on the rail — your work queue. › query Parameters

performer_facility

string · required

facility code

status

string · required

status

Orders routed to this facility from anywhere on the rail — your work queue. › Responses

200

Returns orders[].order_id.

No data returned

Return the result against the order. It reaches the requester without a second integration.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/orders/{order_id}/results

Return the result against the order. It reaches the requester without a second integration.

Not implemented yet. No /orders prefix exists under either version.

Keep from the response: result_ref

Taught in: 05 · Treat

Return the result against the order. It reaches the requester without a second integration. › path Parameters

order_id

string · required

order id

Return the result against the order. It reaches the requester without a second integration. › Request Body

status

string

object[]

object

Return the result against the order. It reaches the requester without a second integration. › Responses

200

Returns result_ref.

No data returned

POST/api/v1/orders/{order_id}/results

curl https://api-dev.slade360edi.com/orchestrator/api/v1/orders/:order_id/results \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "status": "final",
  "observations": [
    {
      "code": {
        "system": "LOINC",
        "code": "718-7"
      },
      "valueQuantity": {
        "value": 9.1,
        "unit": "g/dL"
      },
      "interpretation": "L"
    }
  ],
  "performed_by": {
    "hwr_number": "{{hwr_number}}"
  }
}'

Example Request Body

{
  "status": "final",
  "observations": [
    {
      "code": {
        "system": "LOINC",
        "code": "718-7"
      },
      "valueQuantity": {
        "value": 9.1,
        "unit": "g/dL"
      },
      "interpretation": "L"
    }
  ],
  "performed_by": {
    "hwr_number": "{{hwr_number}}"
  }
}

json

application/json

Example Responses

No example specified for this content type

Prescriptions routed to this pharmacy, written anywhere. Nothing is carried in on paper.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/prescriptions

Prescriptions routed to this pharmacy, written anywhere. Nothing is carried in on paper.

Keep from the response: prescriptions[].prescription_id

Taught in: 05 · Treat

Prescriptions routed to this pharmacy, written anywhere. Nothing is carried in on paper. › Responses

200

Returns prescriptions[].prescription_id.

No data returned

Prescribe. Routed to the pharmacy the patient chooses, which may not be yours.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/prescriptions

Prescribe. Routed to the pharmacy the patient chooses, which may not be yours.

Keep from the response: prescription_id

Taught in: 05 · Treat

Prescribe. Routed to the pharmacy the patient chooses, which may not be yours. › Request Body

object[]

object

route_to_facility

string

Prescribe. Routed to the pharmacy the patient chooses, which may not be yours. › Responses

200

Returns prescription_id.

No data returned

POST/api/v1/prescriptions

curl https://api-dev.slade360edi.com/orchestrator/api/v1/prescriptions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "items": [
    {
      "medication": {
        "system": "KEML",
        "code": "AL-20-120",
        "display": "Artemether/Lumefantrine 20/120mg"
      },
      "dose": "4 tablets",
      "route": "oral",
      "frequency": "BD",
      "duration_days": 3,
      "quantity": 24,
      "substitution_allowed": true
    }
  ],
  "diagnosis": [
    {
      "icd11_code": "1F41"
    }
  ],
  "prescriber": {
    "hwr_number": "{{hwr_number}}"
  },
  "route_to_facility": "{{facility_code}}"
}'

Example Request Body

{
  "items": [
    {
      "medication": {
        "system": "KEML",
        "code": "AL-20-120",
        "display": "Artemether/Lumefantrine 20/120mg"
      },
      "dose": "4 tablets",
      "route": "oral",
      "frequency": "BD",
      "duration_days": 3,
      "quantity": 24,
      "substitution_allowed": true
    }
  ],
  "diagnosis": [
    {
      "icd11_code": "1F41"
    }
  ],
  "prescriber": {
    "hwr_number": "{{hwr_number}}"
  },
  "route_to_facility": "{{facility_code}}"
}

json

application/json

Example Responses

No example specified for this content type

Record what was actually handed over, including a substitution or a partial fill.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/prescriptions/dispense

Record what was actually handed over, including a substitution or a partial fill.

Keep from the response: dispense_id

Taught in: 05 · Treat

Record what was actually handed over, including a substitution or a partial fill. › Request Body

object[]

object

Record what was actually handed over, including a substitution or a partial fill. › Responses

200

Returns dispense_id.

No data returned

POST/api/v1/prescriptions/dispense

curl https://api-dev.slade360edi.com/orchestrator/api/v1/prescriptions/dispense \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "items": [
    {
      "medication": {
        "system": "KEML",
        "code": "AL-20-120"
      },
      "quantity_dispensed": 24,
      "substituted": false,
      "batch": "AL-2411-08"
    }
  ],
  "dispensed_by": {
    "hwr_number": "{{hwr_number}}"
  }
}'

Example Request Body

{
  "items": [
    {
      "medication": {
        "system": "KEML",
        "code": "AL-20-120"
      },
      "quantity_dispensed": 24,
      "substituted": false,
      "batch": "AL-2411-08"
    }
  ],
  "dispensed_by": {
    "hwr_number": "{{hwr_number}}"
  }
}

json

application/json

Example Responses

No example specified for this content type

Remove a doctor from a prescription recorded against the wrong prescriber.

DELETE

https://api-dev.slade360edi.com/orchestrator

/api/v1/prescriptions/doctors

Remove a doctor from a prescription recorded against the wrong prescriber.

Keep from the response: status

Taught in: 05 · Treat

Remove a doctor from a prescription recorded against the wrong prescriber. › Responses

200

Returns status.

No data returned

Generate the documents this claim requires from the clinical data already recorded.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/documents/generate

Generate the documents this claim requires from the clinical data already recorded.

Not implemented yet. No document routes under a visit. Rendering is live at a different address: POST /api/v1/clinical/document-bundles/{id}/pdf renders a bundle, and POST /api/v1/clinical/html-to-pdf converts HTML you supply. Neither generates a document set from a visit's clinical data.

Keep from the response: documents[].document_id

Taught in: 05 · Treat

Generate the documents this claim requires from the clinical data already recorded. › path Parameters

visit_id

string · required

visit id

Generate the documents this claim requires from the clinical data already recorded. › Request Body

document_types

string[]

format

string

Generate the documents this claim requires from the clinical data already recorded. › Responses

200

Returns documents[].document_id.

object[]

POST/api/v1/visits/{visit_id}/documents/generate

curl https://api-dev.slade360edi.com/orchestrator/api/v1/visits/:visit_id/documents/generate \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "document_types": [
    "DISCHARGE_SUMMARY",
    "CLAIM_FORM"
  ],
  "format": "pdf"
}'

Example Request Body

{
  "document_types": [
    "DISCHARGE_SUMMARY",
    "CLAIM_FORM"
  ],
  "format": "pdf"
}

json

application/json

Example Responses

{
  "documents": [
    {
      "document_id": "DOC-2026-08-14-007731",
      "document_type": "DISCHARGE_SUMMARY",
      "status": "generated",
      "attached_to_visit": true,
      "missing": []
    },
    {
      "document_id": null,
      "document_type": "CLAIM_FORM",
      "status": "incomplete",
      "missing": [
        "encounter.period.end",
        "diagnosis.primary"
      ]
    }
  ]
}

json

application/json

Render a document on demand — HTML to show on screen, PDF to hand over or sign.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/documents/{document_type}/render

Render a document on demand — HTML to show on screen, PDF to hand over or sign.

Not implemented yet. No document routes under a visit. GET /api/v1/clinical/document-bundles/{id}/render is the live renderer, scoped to a bundle rather than to a visit and a document type.

Keep from the response: url

Taught in: 05 · Treat

Render a document on demand — HTML to show on screen, PDF to hand over or sign. › path Parameters

visit_id

string · required

visit id

document_type

string · required

document type

Render a document on demand — HTML to show on screen, PDF to hand over or sign. › query Parameters

format

string · required

format

Render a document on demand — HTML to show on screen, PDF to hand over or sign. › Responses

200

Returns url.

No data returned

Refer onward, carrying the clinical record and the authorisation taken here.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/visits/{visit_id}/referrals

Refer onward, carrying the clinical record and the authorisation taken here.

Not implemented yet. No /referrals prefix exists, and there is no referral surface in the service.

Keep from the response: referral_id

Taught in: 05 · Treat

Refer onward, carrying the clinical record and the authorisation taken here. › path Parameters

visit_id

string · required

visit id

Refer onward, carrying the clinical record and the authorisation taken here. › Request Body

to_facility

string

object[]

urgency

string

object

include_clinical

boolean

authorization_ref

string

specimen_accompanying

boolean

Refer onward, carrying the clinical record and the authorisation taken here. › Responses

200

Returns referral_id.

referral_id

string

status

string

to_facility

string

object

POST/api/v1/visits/{visit_id}/referrals

curl https://api-dev.slade360edi.com/orchestrator/api/v1/visits/:visit_id/referrals \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "to_facility": "{{referral_facility}}",
  "reason": [
    {
      "icd11_code": "1F41"
    }
  ],
  "urgency": "routine",
  "requested_service": {
    "system": "ICHI",
    "code": "QBA1"
  },
  "include_clinical": true,
  "authorization_ref": "{{authorization_ref}}",
  "specimen_accompanying": false
}'

Example Request Body

{
  "to_facility": "{{referral_facility}}",
  "reason": [
    {
      "icd11_code": "1F41"
    }
  ],
  "urgency": "routine",
  "requested_service": {
    "system": "ICHI",
    "code": "QBA1"
  },
  "include_clinical": true,
  "authorization_ref": "{{authorization_ref}}",
  "specimen_accompanying": false
}

json

application/json

Example Responses

{
  "referral_id": "REF-2026-08-14-000904",
  "status": "sent",
  "to_facility": "FR-11009",
  "authorization": {
    "authorization_ref": "AUTH-2026-08-14-4471",
    "authenticated_at_facility": "FR-14082",
    "honoured_at_destination": true,
    "expires_at": "2026-08-21T23:59:59+03:00"
  }
}

json

application/json

Referrals sent to this facility, with the record and the authorisation already attached.

GET

https://api-dev.slade360edi.com/orchestrator

/api/v1/referrals

Referrals sent to this facility, with the record and the authorisation already attached.

Not implemented yet. No /referrals prefix exists.

Keep from the response: referrals[].referral_id

Taught in: 05 · Treat

Referrals sent to this facility, with the record and the authorisation already attached. › query Parameters

facility_code

string · required

facility code

direction

string · required

direction

Referrals sent to this facility, with the record and the authorisation already attached. › Responses

200

Returns referrals[].referral_id.

No data returned

Accept or decline a referral, and open the receiving visit against the same authorisation.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/referrals/{referral_id}/accept

Accept or decline a referral, and open the receiving visit against the same authorisation.

Not implemented yet. No /referrals prefix exists.

Keep from the response: visit_id

Taught in: 05 · Treat

Accept or decline a referral, and open the receiving visit against the same authorisation. › path Parameters

referral_id

string · required

referral id

Accept or decline a referral, and open the receiving visit against the same authorisation. › Request Body

decision

string

expected_at

string

object

Accept or decline a referral, and open the receiving visit against the same authorisation. › Responses

200

Returns visit_id.

No data returned

Send a specimen to the hub, tracked against the order that asked for it.

POST

https://api-dev.slade360edi.com/orchestrator

/api/v1/referrals/{referral_id}/samples

Send a specimen to the hub, tracked against the order that asked for it.

Not implemented yet. Hangs off the unregistered /referrals prefix.

Keep from the response: sample_id

Taught in: 05 · Treat

Send a specimen to the hub, tracked against the order that asked for it. › path Parameters

referral_id

string · required

referral id

Send a specimen to the hub, tracked against the order that asked for it. › Request Body

order_id

string

object

cold_chain

boolean

courier_ref

string

Send a specimen to the hub, tracked against the order that asked for it. › Responses

200

Returns sample_id.

No data returned

POST/api/v1/referrals/{referral_id}/samples

curl https://api-dev.slade360edi.com/orchestrator/api/v1/referrals/:referral_id/samples \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "order_id": "{{order_id}}",
  "specimen": {
    "type": "BLD",
    "container": "EDTA",
    "collected_at": "2026-08-14T09:12:00+03:00"
  },
  "cold_chain": true,
  "courier_ref": "CR-88213"
}'

Example Request Body

{
  "order_id": "{{order_id}}",
  "specimen": {
    "type": "BLD",
    "container": "EDTA",
    "collected_at": "2026-08-14T09:12:00+03:00"
  },
  "cold_chain": true,
  "courier_ref": "CR-88213"
}

json

application/json

Example Responses

No example specified for this content type

04 · Visit 06 · Preauthorize