update API to allow search parameters and single entry retrieval