---
title: "Search international art fairs calendar"
method: GET
path: "/api/gpt/art-fairs"
---

# Search international art fairs calendar

`GET /api/gpt/art-fairs`

## Request

- Base URL: `https://mondoir.art`
- URL: `https://mondoir.art/api/gpt/art-fairs`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/mondoir/apis/mondoir-api/docs/api/gpt/art-fairs/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a calendar of major international art fairs and exhibitions worldwide. Can filter by country, type, and upcoming events.

## Query parameters

- `country` string
- `type` string
- `upcoming` boolean
- `limit` integer

## Response `200`

List of art fairs

- ArtFairList
  - `total` integer
  - `items` ArtFair[]
    - `name` string: Art fair name
    - `website` string: Official website URL
    - `dates` string: Date description text
    - `startDate` string, date: Start date
    - `endDate` string, date: End date
    - `type` string: Fair type (Contemporary, Modern, Design, etc.)
    - `city` string: City where fair is held
    - `country` string: Country where fair is held
  - `filters` object
    - `countries` string[]
    - `types` string[]

---

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