Is that a nested object in your pocket, or are you just happy to see me?
It is possible to expand the nested objects within a main object. For example, an Order might have an associated User ID. If you want to expand the actual user information, you can use the expand query parameter.
GET https://api.builton.dev/orders/<order_id>?expand=user HTTP/1.1
order = builton.order().get('<order-id>', expand='user')
You can also nest expand requests with the dot property. For example, requesting payments.payment_method on an order will expand the payments property into a list of Payment objects, and will then expand the payment_method property for each Payment object into a full Payment Method object.
You can expand multiple objects at once. Just separate items in the query with commas.
GET /orders/<order-id>?expand=user,items.product HTTP/1.1