---
title: "Get Jobs"
method: POST
path: "/v3/jobs"
tags: ["Home Services"]
---

# Get Jobs

`POST /v3/jobs`

This endpoint identifies the most relevant job types based on the end user's home service needs. By providing details about what the user is looking for, this endpoint returns multiple matching job types. From these, a single job type is selected and used as input for the Get Survey endpoint to continue the matching flow.

## Request body

- object — Request object for getting jobs based on natural language query.
  - `query` string, required — Natural language text describing the needs.
  - `locale` string, yelp-supported-locale — Locale code in the format of {language code}_{country code}. See the [list of supported locales](https://docs.developer.yelp.com/docs/resources-supported-locales).

## Response `200`

Successfully retrieved jobs

- object — Response object containing matched jobs.
  - `jobs` object[], required
    - `job_alias` string, required — Job alias, e.g. job_faucet_repair.
    - `display_name` string, required — User-friendly name of the job.
    - `description` string, required — A description of the job.

## Other responses

- `400` — Bad Request. Message varies depending on failure scenario
- `401` — The API key has either expired or doesn't have the required scopes to query this endpoint. | code | description | | ------------- | ------------- | | UNAUTHORIZED_API_KEY | The API key provided is not currently able to query this endpoint. | | TOKEN_INVALID | Invalid API key or authorization header. |
- `403` — Authorization Error
- `404` — Resource Not Found
- `429` — You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.
- `500` — Internal Server Error

---

[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)