# Equipment Configuration Survey

The **Equipment Configuration Survey API** allows you to retrieve product-specific survey templates for equipment configuration. Each product has a unique survey consisting of hierarchical questions and available answers that must be completed before placing equipment orders.

### **Available Endpoint:**

* Get Survey: `GET /api/equipment/surveys/{productKey}`

### Additional Information

#### Usage Workflow:

1. **Fetch the latest survey template**\
   Always start by calling `GET /api/equipment/surveys/{productKey}` to retrieve the current survey hierarchy (questions, answer sets, metadata). This ensures your integration uses up‑to‑date templates and avoids breakages if the survey is updated.
2. **Populate survey answers**\
   The survey is a hierarchical JSON of questions; fill each answer field (initially empty or defaulted) with the correct values for your product configuration.
3. **Create the equipment order**\
   Once the survey is fully answered, submit it via `POST /api/equipment/orders` (see the [Equipment Order API](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/equipment-order)) to generate an Order ID and place the order.