Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

This branch is 2 commits ahead, 42 commits behind mikekelly:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

HAL - Hypertext Application Language

A lean hypermedia type

HAL is a simple way of linking with JSON or XML.

It provides a set of conventions for expressing hyperlinks to, and embeddedness of, related resources - the rest of a HAL document is just plain old JSON or XML.

This repo contains a formalised specification of HAL (see

For a friendlier, more pracitcal introduction to HAL you can read this article: JSON Linking with HAL.

Discussion Group

If you have any questions or feedback about HAL, you can message the HAL-discuss mailing list.


If you think some part of the spec needs changing, just fork this repo and raise a pull request with your changes.


Something went wrong with that request. Please try again.