---
title: "Get Board"
method: GET
path: "/api/v1/recommendations"
tags: ["api", "api", "recommendations"]
---

# Get Board

`GET /api/v1/recommendations`

## Request

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

## Query parameters

- `year` integer, nullable: Kalendar yili (standart: joriy)
- `date` string, nullable: Tanlangan kun (dd.MM.yyyy) — items shu kun bo'yicha
- `q` string, nullable: Sarlavha/tavsif bo'yicha qidiruv

## Response `200`

Successful Response

- RecommendationsBoard: `GET /recommendations` yagona javobi: kalendar HAR DOIM keladi, `items` esa so'ralgan kun (date) tavsiyalari (qidiruv bilan filtrlangan). Alohida /calendar endpoint yo'q — kalendar shu javob ichida keladi.
  - `calendar` object
  - `items` RecommendationListItem[]
    - `id` string, required
    - `title` string, required
    - `description` string
    - `is_visible` boolean
    - `doing_time` integer
    - `meaning_category` 'mottivation' | 'doingWork' | 'havingRest' | 'enjoying' | 'learning' | 'encorage' | 'punishing' | 'upbringing' | 'phythicExercese' | 'other': Tavsiya (recommendation) ma'no-kategoriyasi. Qiymatlar frontend modeli bilan AYNAN mos kelishi shart (ba'zilari ataylab "xato" yozilgan — mobil ilova shu satrlarga bog'langan): `RecommendationModel.meaning_category`.
    - `start_age` integer
    - `end_age` integer
    - `is_every_day` boolean
    - `scheduled_at` string, nullable
    - `begin_date` string, nullable
    - `end_date` string, nullable
    - `link_type` string
    - `link_id` string
    - `link_parent_id` string
    - `link_title` string
    - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/faroz/apis/edu-app-api.md) · [All operations](https://skmtc.dev/faroz/apis/edu-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faroz/apis/edu-app-api/revisions/414a551ba773?raw)