JSON API docs draft #18