Tross
EZDERM

Place lab order

Place selected lab tests for one recipient.

POSThttps://api.ontross.com/api/integrations/ezderm/place-lab-order
Request Fields
input.encounter_id
string
required
Visit identifier supplying the patient, clinician, and suggested tests.
Example
"d26f8a40-3b17-4c95-ae82-608c7f0db541"
input.recipient_id
string
required
Active address book contact UUID from list-lab-recipients.
Example
"b72d163e-508a-4ef9-b682-9c37af5410de"
input.tests
array
required
Unique problem and service pairs selected from current suggestions.
input.tests[].problem_id
string
required
Medical problem UUID from a suggested test group.
Example
"7c1d4e62-2a53-4f88-9b0e-41d7c6a5e210"
input.tests[].primary_service_identifier
string
required
Exact service code from a test within that group.
Example
"85025"
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
order_ids
array
Generated uppercase UUIDs for laboratory tests, preserving selection order.
documents
array
Generated document metadata returned after placing the selected tests.
documents[].id
string
Document identifier returned by the order placement response.
Example
"a60318d2-945f-4b78-a1ce-27e895f60c43"
documents[].name
string
Generated document label returned after placing laboratory orders.
Example
"Laboratory requisition.pdf"
documents[].mime_type
string
Server content type for the generated order document.
Example
"application/pdf"
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/ezderm/place-lab-order \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"encounter_id":"d26f8a40-3b17-4c95-ae82-608c7f0db541","recipient_id":"b72d163e-508a-4ef9-b682-9c37af5410de","tests":[{"problem_id":"7c1d4e62-2a53-4f88-9b0e-41d7c6a5e210","primary_service_identifier":"85025"}]},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "encounter_id": "d26f8a40-3b17-4c95-ae82-608c7f0db541",
    "recipient_id": "b72d163e-508a-4ef9-b682-9c37af5410de",
    "tests": [
      {
        "problem_id": "7c1d4e62-2a53-4f88-9b0e-41d7c6a5e210",
        "primary_service_identifier": "85025"
      }
    ]
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "order_ids": [
      "string"
    ],
    "documents": [
      {
        "id": "a60318d2-945f-4b78-a1ce-27e895f60c43",
        "name": "Laboratory requisition.pdf",
        "mime_type": "application/pdf"
      }
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}