Would be good to see the entire script including how you get the siblings and return the values, to make sure there's no errors in there. What you posted looks fine.. though I would normally do it slightly different (but in essence the same):
foreach ($siblings as $res) {
$output .= $res->get('id');
}
As for the API docs, that comes straight from the code's phpdoc comments so I suppose that's not entirely the right place for extensive examples.. that probably should get a place of its own though.
If you're going into much development, it's probably best to keep the xPDO documentation nearby, this class reference can be of enormous help (and has quite some examples):
http://rtfm.modx.com/display/xPDO20/Class+Reference
The modX class is an extension to xPDO so it inherits all of its methods. All objects (users, resources, menus, etc) extend xPDOObject so they use all of those methods as well.
[ed. note: markh last edited this post 12 years, 7 months ago.]