API User Licence v2.0


  1. Welcome to Festivals Edinburgh. This document sets out the terms and conditions under which we - Festivals Edinburgh Limited, a company registered in Scotland (No. SC331673), whose registered office is at Business Centre 2.6, Waverley Court, 4 East Market Street, Edinburgh EH8 8BG - permit you to use the Edinburgh Festivals Listings API ("the API").
  2. The API is made available on an "as is" basis and for that reason you should in particular read the section headed "disclaimers" below.


  1. This agreement is formed if and when you register for access to the API and we accept your registration. By applying for access to the API you agree that, if your application is accepted, you will abide by these terms and conditions.
  2. If you are an individual and intend to use, or do use, the API in the course of your employment, then you agree, on behalf of your employer, that your employer will also be bound by this agreement and that you have the authority to agree to these terms and conditions on your employer's behalf.
  3. In this agreement:
    1. "the API" refers to the listings data API, described at https://api.edinburghfestivalcity.com/
    2. "Fringe" means the Edinburgh Festival Fringe.
    3. "Fringe data" means data concerning shows and events forming part of the Edinburgh Festival Fringe.
    4. "writing" includes electronic mail, but not instant messaging or SMS text messages;
    5. "listings data" refers to any data made available to you by use of the API.

User privileges

  1. Each API will be associated with a set of privileges defined by a "use type" which will determine the use that you are allowed to make of that API and the conditions associated with that use when you are using that API key. In outline, the three use types are:
    • A - a generic use type which is the default.
    • B - intended for use by media organisations.
    • C - intended for application developers.
  2. Use type A will not be permitted to access Fringe data. Use types B and C will be able to access Fringe data.
  3. We would prefer you to register for a separate API key for each distinct use (website, application) for which you make of the listings data. You will need to do this if you wish more than one use type at the same time (for example if you are a media organisation that is also developing applications based on the listings data). If you have any questions about which API key to use, or want to request a different use type, please feel free to contact us at support@api.edinburghfestivalcity.com .

Permitted use for all use types

  1. Subject to this agreement, you may do any of the following:
    1. produce works using or incorporating the listings data for any lawful purpose, including commercial applications
    2. modify, transform and build upon the listings data
  2. You may only use the API if you have registered with us and been allocated an API key.
  3. In order to support data accuracy, you must ensure that all applications and/or associated servers check for updates from the API at least every 24 hours. The API allows for querying by updated field with notes available in the API documentation.
  4. In relation to any event, other than one associated with the Fringe, you must ensure no links associated with that event target any ticketing website other than:
    1. the individual festival websites;
    2. a website operated by a venue for purchase of tickets to an event taking place at that venue only; or
    3. www.edinburghfestivalcity.com
  5. You must ensure that all links to individual Fringe shows or events deep link to the appropriate URL on the edfringe.com website, for example https://www.edfringe.com/whats-on/childrens-shows/revolting-rhymes. Links relating to Fringe shows or events must not be made to any other ticketing site, including the venue's own site.
  6. If we believe that your use of the listings data is offensive, misleading or inaccurately represents the data in any way, we may, in our absolute discretion, request that you amend or remove any published material derived from the listings data. You must promptly comply with any such request.

Further conditions - use type A

  1. If you are a type A user, you must comply with all the conditions under this heading.
  2. Where you publish any work that is derived from the listings data:
    1. You must attribute it to the Edinburgh Festivals Listings API, for example by stating "data provided courtesy of the Edinburgh Festivals Listings API" or similar.
    2. Any attribution should include a reference to the API web page at https://api.edinburghfestivalcity.com/ which, where the nature of the work permits (for example in the case of a web page or PDF) in the form of a hyperlink to that web address.
    3. You must state that any applications developed using or incorporating the listings data are not official festival applications unless this has been explicitly agreed in writing with us, or the relevant festival organisation.
  3. In order to support data integrity, you must not redistribute listings to third parties by means of either data feeds or data dumps.

Further conditions - use type B

  1. Subject to this agreement, you may also publish and distribute the listings data through your own channels.
  2. You must not share the listings data in the form of a static dump other than internally within your organisations for use in your own publications.
  3. We realise that the nature of your use of a type B API may make it difficult or impossible to meaningfully attribute the source of the listings data to us. We ask that you give reasonable attribution to us where it is reasonably practical for you to do so.

Further conditions - use type C

  1. You will only be allowed access to a live version of the listings API once your applications has been tested and approved by us.
  2. Your application must state clearly, in a place that will be seen by users of your application each time the use it that:
    1. its data source is the Edinburgh Festivals Listings API by stating in an appropriate place that data has been provided "data provided courtesy of the Edinburgh Festivals Listings API" or similar including a link (where possible) to api.edinburghfestivalcity.com;
    2. it is not an official festival application (unless this has been explicitly agreed in writing with us, or the relevant festival organisation).
    3. You must further support data accuracy by ensuring that any client applications, where-ever practical, attempt to retrieve fresh listings data if they have been offline for periods of longer than 24 hours.
    4. In order to support data integrity, you must not redistribute listings to third parties by means of either data feeds or data dumps.
    5. You must re-submit any application for testing and approval where significant changes to the application, such as the interpretational presentation of data, or functionality based on new material, are introduced. You may not publish or allow access to the version of the application that has been re-submitted to us, until we have given our approval for its use.


  1. We may terminate this agreement if:
    1. we are required to do so by law;
    2. we reasonably believe that you have failed to comply with any terms of this agreement.
  2. You may terminate this agreement by sending us notice in writing.
  3. If this agreement comes to an end for any reason:
    1. we may prevent any further access to the API using your API key; and
    2. you must delete all listings data that is under your control.

Changes to Terms and Conditions

  1. We may amend these terms and conditions from time to time by posting a new version to the site. If you continue to use the API after we have changed these terms and conditions, you will be deemed to have accepted any changes we have made. If you do not wish to be bound by a change in the terms and conditions, you should terminate the agreement.



The nature of these terms and conditions is purely permissive. We permit you to use the API as and when it is available. We do not contract to make it available now or at any time or to provide any particular level of service and we reserve the right to suspend the availability of the API at any time. You should therefore make sure that you do not rely on the availability of the API for anything critical to you or your business.

The information available using this site is compiled from a variety of sources. While we hope that it is accurate and complete, we cannot ensure that it is. In using the site you accept that the information available may be inaccurate or incomplete.

Therefore, except in so far as we are prevented from doing so by law, we exclude all liability arising from your use of the site for any reason including (but not limited to) its failure to operate, its returning of inaccurate or incomplete information or otherwise failing to generate data in accordance with its documented API.

  1. For the reasons set out in the "Warning" section above, you agree that:
    1. we will not be liable to you for any indirect or consequential damages however they might have been caused and even if they were due to our, our or contractor's negligence;
    2. we will not be liable for any loss of profit, opportunity or data.
  2. We do not give you any warranty as to the accuracy of the data, the reliability of the API or the suitability of the API for any particular purpose. Any implied terms as to quality or fitness are excluded as far as it is lawful to do so.


  1. You agree that we may process your personal data in accordance with our privacy policy.
  2. You may be invited (once only) to participate in a short case-study interview to help support the festivals' understanding of open data approaches in the cultural sector.


  1. This agreement shall be governed by and shall be construed in accordance with English law. Each party also agrees, to the extent that is permissible by law, to submit to the exclusive jurisdiction of the courts of England and Wales.
  2. Any delay in exercising or any complete or partial failure by us to exercise any right under this agreement does not constitute a waiver of that right.
  3. If any terms of this agreement are held to be void or contrary to law, then they shall be severed from the remainder of the agreement, which shall be read so far as possible without them.
  4. The Contracts (Rights of Third Parties) Act does not apply to this agreement.
  5. Nothing in this agreement constitutes a Partnership between the parties.
  6. Nothing in these terms and conditions is a restriction of liability for death or personal injury resulting from any fault on our behalf, nor does it curtail or restrict your statutory rights.