Introduce 'curies'

TODO:

- [x] update doc to reflect changes in API responses