Documentation > Resources > Fairs

Fairs API

An art fair is an event to which partners bring shows with artworks.

Retrieving Fairs

Retrieve fairs by following the fairs link from root.

curl -v "https://api.artsy.net/api/fairs" -H "X-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.

Retrieving a Fair

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:..."

Fair JSON Format

Key Description
id Unique id.
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.
name Fair name.
about About the fair.
contact Fair contact information.
summary Fair summary.
start_at Fair start date.
end_at Fair end date.
status Fair status, one of "running", "closed", "upcoming" or "current".
published Whether fair is available for public consumption.

Links

Key Target
self The fair resource.
shows Fair shows.

Example

{
  "id": "543865d4726169329c350300",
  "created_at": "2014-10-10T23:03:48+00:00",
  "updated_at": "2017-07-07T12:36:48+00:00",
  "name": "Zsona MACO 2015",
  "about": "**Zsona MACO 2015**  \r\n\r\nZsona Maco is one of the most highly anticipated fairs for contemporary art from Latin America.  \r\n\r\nThe fair takes place in Mexico City from February 4-8, 2015 and celebrates local and international collectors, specialists, and galleries. Founded by Zélika García in 2002, Zsona Maco has established itself as one of the most notable art world events for the sale, exhibition and promotion of international contemporary art in the region.  \r\n\r\nThe fair includes five sections -- General, New Proposals, Zsona Maco South, Modern Art and Design -- selected by an international committee of renowned curators and specialists curators.  \r\n\r\n[**BUY TICKETS HERE**]  \r\n\r\n[**General Admission**](https://www.srpago.com/red/?wapps=WPOS) and [**Student + Child**](https://www.srpago.com/red/?wapps=WPOS)\r\n\r\n---  \r\n\r\nZsona Maco, la feria de arte contemporáneo más importante de América Latina, concentra cada año en la Ciudad de México a coleccionistas, especialistas y galerías de todas partes del mundo.  \r\n\r\nFundada por Zélika García en 2002, Zona Maco se ha consolidado como una de las plataformas más notables para venta, exposición y promoción del arte contemporáneo internacional de esta región.  \r\n\r\nAnualmente la feria ofrece en sus cinco secciones: General, Nuevas Propuestas, Zsona Maco Sur, Arte Moderno y Diseño, las propuestas de más de cien galerías, editoriales e instituciones culturales; invitadas a través de un proceso de selección a cargo de un comité internacional, conformado por reconocidos galeristas y curadores especialistas de cada sección.\r\n\r\n**COMPRA TUS BOLETOS EN LINEA**  \r\n\r\n[**General Admission**](https://www.srpago.com/red/?wapps=WPOS) and [**Student + Child Admission**](https://www.srpago.com/red/?wapps=WPOS)\r\n\r\n",
  "contact": "Zsona MACO  \r\nMéxico Arte Contemporáneo  \r\nLuis G. Urbina 4 int. 104  \r\nMéxico D.F. C.P. 11560  \r\nT. + 52 (55) 5280 6073  \r\nF. + 52 (55) 5280 8247  \r\n\r\n\r\n**info@zonamaco.com**",
  "summary": "",
  "start_at": "2015-02-04T12:00:00+00:00",
  "end_at": "2015-02-08T20:00:00+00:00",
  "status": "closed",
  "published": true,
  "_links": {
    "self": {
      "href": "https://api.artsy.net/api/fairs/543865d4726169329c350300"
    },
    "shows": {
      "href": "https://api.artsy.net/api/shows?fair_id=543865d4726169329c350300"
    }
  }
}