Skip to content
The RFC for application/hal+json

The hal+json specification

The easiest place to read it is here:

Please contribute proposals for changes that you think will improve the spec!

How to propose a change


Edit either the txt or the xml file, whichever one you want - and submit as a pull request.


The txt is actually generated from the xml so it's better if you edit the latter. You also get extra brownie points if you:

  • install xml2rfc (pip install xml2rfc)
  • generate the txt from the xml
  • submit both in your PR
Something went wrong with that request. Please try again.