---
title: "Recommend"
method: POST
path: "/recommendations"
tags: ["recommendations"]
---

# Recommend

`POST /recommendations`

## Request

- Base URL: `https://api.emile.wine` (the document declares no server; this is the origin it was published from)
- URL: `https://api.emile.wine/recommendations`
- Auth: HTTP bearer

Pre-score bottles deterministically, then LLM-rerank top when a dish is set.

## Headers

- `X-API-Key` string, nullable

## Request body

- RecommendationRequest
  - `maturity` boolean
  - `food` string, nullable
  - `filters` FilterCriteriaPayload
    - `colors` string[]
    - `window` 'all' | 'drinkable' | 'aging' | 'passed'
    - `statuses` string[]
    - `regions` string[]
    - `countries` string[]
    - `grapes` string[]
    - `price_min` number, nullable
    - `price_max` number, nullable
    - `full_text` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/emile/apis/emile-api.md) · [All operations](https://skmtc.dev/emile/apis/emile-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emile/apis/emile-api/revisions/eb2d1d1db972?raw)