Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, will remain available until July 28th, 2025. This change will not affect integration partners using our partner api.
If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.
Public API Documentation > Resources > Fairs
An art fair is an event to which partners bring shows with artworks.
Retrieve fairs by following the fairs link from root.
curl -v "https://api.artsy.net/api/fairs" -H "X-XAPP-Token: XAPP_TOKEN"
This endpoint accepts the following parameters.
| Name | Value |
|---|---|
| status | One of 'running', 'closed', 'upcoming' or 'current'. |
The response is a paginated result with embedded fairs.
Users can retrieve a specific fair by ID by rendering the "fair" link template from root.
curl -v "https://api.artsy.net/api/fairs/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
| Key | Target |
|---|---|
| self | The fair resource. |
| shows | Fair shows. |
error: the server responded with status 429