---
title: "List works"
method: GET
path: "/works"
---

# List works

`GET /works`

## Request

- Base URL: `https://ehtekunst.ee/api/v1`
- URL: `https://ehtekunst.ee/api/v1/works`
- Auth: none required

## Query parameters

- `query` string
- `artist` string
- `material` string
- `yearFrom` integer
- `yearTo` integer
- `forSale` boolean
- `page` integer
- `perPage` integer

## Response `200`

Paginated list with attribution meta.

- ListEnvelope
  - `data` unknown[], required
    - unknown
  - `meta` ListMeta, required
    - `page` integer, required
    - `perPage` integer, required
    - `total` integer, required
    - `source` string, required
    - `license` string, required
    - `attributionUrl` string, required

## Other responses

- `429`: Rate limit exceeded (120 req/min/IP).

---

[API](https://skmtc.dev/ehtekunst/apis/ehtekunst-ee-public-api.md) · [All operations](https://skmtc.dev/ehtekunst/apis/ehtekunst-ee-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ehtekunst/apis/ehtekunst-ee-public-api/revisions/85ab53b8c09f?raw)