I do think the client library is very 'id' based, rather than object based. It seems better to return an Order object here, and then consider adding manager methods that take objects in addition to 'id's. Let's talk about that later thoiugh...