Anamnesis

Submit external anamnesis data and connect it to patients

Anamnesis

The Anamnesis API allows external providers to submit medical questionnaire responses (anamnesis data) and connect them to patients in the RxScale system.

Base Path

/api/v3-1/anamnesis

Authentication

All endpoints require an API key via the X-API-Key header. See Authentication for details.

The legacy X-RxScale-Authorization header is also supported for backward compatibility but X-API-Key is recommended for new integrations.

Submit External Anamnesis

Submit anamnesis data from an external provider for a specific questionnaire.

POST /api/v3-1/anamnesis/questionnaires/{questionnaire_uid}/external/submissions

questionnaire_uid · string · required

The UID of the questionnaire to submit against

Request Body

{
  "data": {
    "lastName": "Müller",
    "dob": "1990-05-15"
  },
  "anamnesis_provider_uid": "fc9ef771-79a4-4f60-a930-d62a3527565e",
  "external_identifier": "ext-submission-001"
}

Field	Type	Required	Description
data	object	Yes	The anamnesis response data. Structure depends on the questionnaire definition
anamnesis_provider_uid	string	Yes	Your anamnesis provider UID (provided by RxScale)
external_identifier	string	Yes	Your external identifier for this submission (for tracking)

Example Request

curl -X POST "https://api.rxscale.com/api/v3-1/anamnesis/questionnaires/abc123-def456/external/submissions" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {"lastName": "Müller", "dob": "1990-05-15"},
    "anamnesis_provider_uid": "fc9ef771-79a4-4f60-a930-d62a3527565e",
    "external_identifier": "ext-submission-001"
  }'

The data object structure must match the fields defined in the questionnaire. Contact your RxScale account manager to get the questionnaire schema.

Connect Anamnesis to Patient

Link a submitted anamnesis to a patient profile using their shop customer ID.

POST /api/v3-1/anamnesis/{anamnesis_uid}/patient

anamnesis_uid · string · required

The UID of the anamnesis submission to connect

Request Body

{
  "shop_identifier": "my-store.myshopify.com",
  "shop_patient_id": "CUST123"
}

Field	Type	Required	Description
shop_identifier	string	Yes	Your shop identifier
shop_patient_id	string	Yes	The customer ID from your shop system

Example Request

curl -X POST "https://api.rxscale.com/api/v3-1/anamnesis/xyz789/patient" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_identifier": "my-store.myshopify.com",
    "shop_patient_id": "CUST123"
  }'

Each anamnesis submission can only be connected to one patient. Attempting to connect an already-connected anamnesis will result in an error.

Typical Integration Flow

1. Submit Anamnesis

   Your external system collects patient questionnaire responses and submits them via the external submissions endpoint.

2. Receive Anamnesis UID

   The API returns an anamnesis UID that you store alongside the submission in your system.

3. Connect to Patient

   When the patient is identified in your shop (e.g., during checkout), connect the anamnesis to their patient profile.

4. Doctor Review

   The connected anamnesis becomes available for doctor review in the RxScale doctor portal.