add the 3 key read-only methods for the api