Ok I have posted up the documentation for the API here. And the final revisions are in Mercurial, this has taken into account all the suggestions made here.
Thank's all for the input!