Skip to main content

​
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"
}
FieldTypeRequiredDescription
dataobjectYesThe anamnesis response data. Structure depends on the questionnaire definition
anamnesis_provider_uidstringYesYour anamnesis provider UID (provided by RxScale)
external_identifierstringYesYour 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"
}
FieldTypeRequiredDescription
shop_identifierstringYesYour shop identifier
shop_patient_idstringYesThe 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.