flesh out 'links' api
return status based on ref search