Did you find what you were looking for?
Yes | No | Close

API Keys

TheyWorkForYou API

Current API users: We realise the inconvenience of adding a key to an API that previously did not require one. However, we feel it is now necessary in order to monitor the service for abuse, help with support and maintenance, locate large volume/ commercial users to ask them to contribute to our costs, and provide you with usage statistics.

TheyWorkForYou API calls require a key, so that we can monitor usage of the service, and provide usage stats to you. The key is tied to your TheyWorkForYou account, so if you don't yet have one, please sign up, then return here to get a key.

Sign in (or sign up) to get an API key.

API Functions

  • convertURL
    Converts a parliament.uk Hansard URL into a TheyWorkForYou one, if possible
  • getConstituency
    Searches for a constituency and returns details
  • getConstituencies
    Returns list of constituencies
  • getPerson
    Returns main details for a person
  • getMP
    Returns main details for an MP
  • getMPInfo
    Returns extra information for a person
  • getMPsInfo
    Returns extra information for one or more people
  • getMPs
    Returns list of MPs
  • getLord
    Returns details for a Lord
  • getLords
    Returns list of Lords
  • getMLA
    Returns details for an MLA
  • getMLAs
    Returns list of MLAs
  • getMSP
    Returns details for an MSP
  • getMSPs
    Returns list of MSPs
  • getGeometry
    Returns centre, bounding box of constituencies
  • getCommittee
    Returns members of Select Committee
  • getDebates
    Returns Debates (either Commons, Westminster Hall, or Lords)
  • getWrans
    Returns Written Answers
  • getWMS
    Returns Written Ministerial Statements
  • getHansard
    Returns any of the above
  • getComments
    Returns comments
  • postComment - not written yet
    Posts a comment - needs authentication!