---
title: "easyJet Holidays Hackathon"
description: "The data and APIs available to hackathon teams, and how to get running."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.easyjet-hackathon.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# easyJet Holidays Hackathon

Everything you need to build with easyJet holidays data. One hosted API gives you
live holiday search, TripAdvisor content, and anonymised booking and customer
satisfaction data. Nothing to install.


- **Get running** — Get the URL and the key, check it works.

[Hackathon API](/hackathon-api)
- **Search and content** — Package search, hotel content, destination codes, TripAdvisor.

[REST proxy](/rest-api)
- **Bookings and satisfaction** — Query bookings, survey scores and members, with joins.

[GraphQL API](/graphql-api)


## The short version

```sh
export API=https://api.easyjet-hackathon.uk
export KEY=the-key-everyone-shares

curl $API/health
curl -H "x-api-key: $KEY" $API/api/geography
```

Then open `$API/graphql` in a browser to explore the data — the key is already
filled in there. Every other request needs `x-api-key: $KEY`.

## What the data is

- **Live** — package search, hotel content and TripAdvisor come from the real APIs
  through a caching proxy.
- **Real but anonymised** — bookings and post-holiday surveys are genuine
  production extracts with identifiers replaced and free text scrubbed.
- **Partly fabricated** — the link between a survey and a booking is currently
  invented. Every survey row says which it is. Read
  [the warning](/graphql-api#read-this-before-you-trust-a-join) before you build
  anything that joins satisfaction to booking value.

> **Point your AI tools at these docs**
>
> This site publishes `/llms.txt` and a markdown version of every page. Give your
> coding agent `https://docs.easyjet-hackathon.uk/llms.txt` and
> it can read the whole API reference.

Source: https://docs.easyjet-hackathon.uk/welcome/index.mdx