Skip to main content
POST
Submit referral intake answers (partner-collected, self-hosted)

Authorizations

Authorization
string
header
required

API key issued by VitaRelay. Send as Authorization: Bearer vr_live_… (production) or Authorization: Bearer vr_test_… (sandbox).

Path Parameters

patientId
string<uuid>
required

Body

application/json
responses
object
required

The medical questionnaire answers. Must include these six required fields or the request is rejected 422: treatment_need (array or non-empty string), treatment_reason (non-empty string), current_meds (present; "" or "none" are valid), has_allergies (present), attest_accurate (boolean true), attest_telehealth (boolean true).

pharmacy_product_id
string

Optional. The requested 503A product id (from /rx/catalog). The prescriber still decides.

external_intake_id
string

Optional idempotency key.

Response

Intake submitted and routed to the IDN.

data
object