> ## Documentation Index
> Fetch the complete documentation index at: https://api.vitarelay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intake answers reference

> The exact keys, types and allowed values for the responses object in POST /v1/intakes.

`POST /v1/intakes` takes a free-form `responses` object, but the prescriber's intake document is built from a **fixed
questionnaire**. Each answer is looked up by its **key** (the `id` below). A key that isn't on this list isn't matched:
the question shows **Not answered**, and your value appears only under "Additional information". Nested objects and
arrays of objects are printed as raw text, so send plain strings, numbers, booleans and arrays of strings.

<Note>
  The response to `POST /v1/intakes` includes a `warnings` object that tells you what didn't match, so you can fix the
  mapping in testing without waiting for a document: `unknown_keys`, `missing_required`, `invalid_values` and `complete`.
  Warnings never block the request.
</Note>

## Example that matches the form

```json theme={null}
{
  "category": "async",
  "external_patient_id": "pat_123",
  "external_intake_id": "intake_123",
  "responses": {
    "treatment_need": [
      "weight_loss"
    ],
    "confirm_name": "Willie Zanders",
    "confirm_dob": "1980-05-06",
    "gender": "male",
    "phone": "(713) 555-0100",
    "email": "w@example.com",
    "current_meds": "None",
    "has_allergies": "no",
    "conditions": [
      "none"
    ],
    "nicotine": "never",
    "alcohol": "occasional",
    "activity_level": "light",
    "height": "6'4\"",
    "weight": 297,
    "treatment_reason": "Get to a healthy weight",
    "prior_use": "no",
    "attest_accurate": true,
    "attest_telehealth": true
  }
}
```

Sending this returns `"warnings": { "complete": true, "unknown_keys": [], "missing_required": [], "invalid_values": [] }`.

## Which questions apply

* `category: "async"` answers the **general** set (Set A).
* `category: "hormone"` — or any intake whose `treatment_need` includes `hormone_hrt` — adds the **hormone** set (Set B).
* Questions marked "Asked when" are required only when their condition is true.
* Height is text such as `5'6"`; weight is a **number in pounds**. Convert from metric before sending.
* Gender controls which pregnancy and sex-specific questions apply. Use `female`, `male`, `nonbinary` or `prefer_not_say`.

## General questions (Set A)

### What do you need today?

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `treatment_need` | array of values | Yes | `hormone_hrt`, `weight_loss`, `peptides`, `sexual_health`, `hair`, `sleep`, `longevity`, `other` | always |
| `treatment_need_other` | string | No | Free text: Tell us what you're looking for | when the matching answer is chosen |

### Identity & contact

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `confirm_name` | string | Yes | | always |
| `confirm_dob` | string `YYYY-MM-DD` | Yes | | always |
| `gender` | one value | Yes | `female`, `male`, `nonbinary`, `prefer_not_say` | always |
| `phone` | string | Yes | | always |
| `email` | string | Yes | | always |

### Medications & allergies

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `current_meds` | string | Yes | | always |
| `has_allergies` | `"yes"` or `"no"` | Yes | | always |
| `allergy_detail` | string | No | Free text: Describe the allergy and reaction | when the matching answer is chosen |

### Medical history

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `conditions` | array of values | Yes | `heart_disease`, `high_bp`, `stroke_clots`, `liver_disease`, `kidney_disease`, `thyroid`, `diabetes`, `stomach_gastro`, `cancer`, `seizure`, `mental_health`, `other`, `none` | always |
| `heart_disease_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `high_bp_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `stroke_clots_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `liver_disease_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `kidney_disease_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `thyroid_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `diabetes_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `stomach_gastro_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `cancer_detail` | string | No | Free text: Cancer type & year | when the matching answer is chosen |
| `seizure_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `mental_health_detail` | string | No | Free text: Tell us more about this | when the matching answer is chosen |
| `conditions_other` | string | No | Free text: Which condition? | when the matching answer is chosen |
| `surgeries` | string | No | | always |
| `nicotine` | one value | Yes | `never`, `former`, `current` | always |
| `alcohol` | one value | Yes | `none`, `occasional`, `regular` | always |
| `activity_level` | one value | Yes | `sedentary`, `light`, `moderate`, `very_active`, `athlete` | always |
| `recent_a1c` | string | No | Leave blank if you don't know it. | `treatment_need` includes `weight_loss` |

### Vitals & body metrics

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `height` | string | Yes | Example: 5'6" | always |
| `weight` | number | Yes | | always |
| `blood_pressure` | string | No | | always |

### Pregnancy

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `pregnant_or_breastfeeding` | `"yes"` or `"no"` | Yes | | gender is `female` |
| `planning_pregnancy_6mo` | `"yes"` or `"no"` | Yes | | gender is `female` |

### Reason for treatment

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `treatment_reason` | string | Yes | | `treatment_need` does not include `hormone_hrt` |
| `prior_use` | `"yes"` or `"no"` | Yes | | always |
| `prior_med_name` | string | Yes | | `prior_use` is `yes` |
| `prior_last_taken` | string `YYYY-MM-DD` | Yes | | `prior_use` is `yes` |
| `prior_dose` | string | Yes | For example: 0.5 mg | `prior_use` is `yes` |
| `prior_frequency` | one value | Yes | `daily`, `weekly`, `biweekly`, `other` | `prior_use` is `yes` |
| `prior_frequency_other` | string | No | Free text: Tell us how often | when the matching answer is chosen |
| `prior_results` | string | No | | `prior_use` is `yes` |

### Attestations

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `attest_accurate` | `true` | Yes | | always |
| `attest_telehealth` | `true` | Yes | | always |

## Hormone questions (Set B)

Added when `category` is `hormone`.

### Hormone symptoms

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `hormone_symptoms` | array of values | Yes | `low_energy`, `low_libido`, `mood`, `muscle`, `weight_gain`, `sleep`, `hot_flashes`, `irregular_cycles`, `other` | always |
| `hormone_goals` | string | No | | always |

### Prior hormone therapy

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `prior_hormone_therapy` | `"yes"` or `"no"` | Yes | | always |
| `prior_ht_type` | array of values | No | `test_injections`, `test_cream`, `test_pellets`, `estrogen`, `progesterone`, `hcg`, `clomiphene`, `thyroid`, `other` | `prior_hormone_therapy` is `yes` |
| `prior_ht_type_other` | string | No | | `prior_hormone_therapy` is `yes` |
| `prior_ht_last_used` | string | No | | `prior_hormone_therapy` is `yes` |
| `prior_ht_side_effects` | string | No | | `prior_hormone_therapy` is `yes` |
| `avg_sleep_hours` | string | No | | always |
| `used_anabolics` | `"yes"` or `"no"` | Yes | | always |
| `anabolics_detail` | string | No | Free text: Please explain | when the matching answer is chosen |

### Recent lab work

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `recent_labs` | `"yes"` or `"no"` | Yes | | always |
| `labs_date` | string `YYYY-MM-DD` | No | Required if you answered yes above. | `recent_labs` is `yes` |
| `lab_results_notes` | string | No | Paste any values or notes from your recent labs. | always |
| `lab_values` | string | No | Total T, Free T, Estradiol, TSH, PSA, CBC, Lipids, A1c | always |
| `lab_upload` | storage path (skip) | No | Saved to your secure medical vault. | always |

### Risk history

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `cancer_history` | array of values | Yes | `none`, `breast`, `prostate`, `ovarian`, `uterine`, `other` | always |
| `clot_cvd_history` | `"yes"` or `"no"` | Yes | | always |
| `clot_cvd_detail` | string | No | Free text: Describe | when the matching answer is chosen |

### Male-specific

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `male_prostate_history` | array of values | Yes | `prostate_cancer`, `bph`, `elevated_psa`, `difficulty_urinating`, `fertility_concerns`, `testicular_injury`, `ed`, `low_sperm`, `none` | gender is `male` |
| `male_trying_children` | one value | Yes | `no`, `yes`, `maybe` | gender is `male` |

### Female-specific

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `female_pregnant` | `"yes"` or `"no"` | Yes | | gender is `female` |
| `female_menstruating` | `"yes"` or `"no"` | Yes | | gender is `female` |
| `female_lmp` | string `YYYY-MM-DD` | No | | gender is `female` |
| `female_periods` | array of values | No | `regular`, `irregular`, `heavy`, `painful`, `na` | gender is `female` |
| `female_hysterectomy` | `"yes"` or `"no"` | Yes | | gender is `female` |
| `female_ovaries_removed` | `"yes"` or `"no"` | Yes | | gender is `female` |
| `female_birth_control` | `"yes"` or `"no"` | Yes | | gender is `female` |
| `female_birth_control_type` | string | No | Free text: Birth control type | when the matching answer is chosen |

### Hormone-therapy attestation

| Key | Type | Required | Allowed values | Asked when |
| - | - | - | - | - |
| `attest_hormone_telehealth` | `true` | Yes | | always |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.