---
title: "Get Survey"
method: GET
path: "/v3/jobs/{job_alias}/survey"
tags: ["Home Services"]
---

# Get Survey

`GET /v3/jobs/{job_alias}/survey`

This endpoint returns a tailored set of questions and required information based on the provided job alias. This information must be collected from the end user in order to create a project submission. A project submission is how we match users with qualified home service providers — the more accurately this data is filled out, the higher the quality of the submission, leading to better and more relevant matches.

## Path parameters

- `job_alias` string, required

## Response `200`

Success

- object
  - `job_alias` string, required — The job alias for the survey.
  - `questions` object[], required
    - `question_alias` string, required — The alias for the survey question.
    - `question_text` string, required — The text of the survey question.
    - `available_choices` string[], required — The available choices for the survey question.
    - `only_accepts_choices` boolean, required — Whether the survey question only accepts predefined choices.
    - `is_multi_select` boolean, required — Whether the survey question allows selecting multiple available choices.
    - `is_required` boolean, required — Whether the survey question is required.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)