I didn't use the API yet ;) I just help the team to migrate the code to respect PHP standard... so it must return the most coherent piece of information: repository name, document reference, etc ...