# Embedded resources

This topic describes how to pre-load additional objects with an API request.
These additional objects are referred to as embedded resources.

Use the `?expand` query parameter to expand and include embedded objects within the `_embedded` property of the response. The `_embedded` property contains an array of objects keyed by the expand parameter values. To expand multiple objects, pass them as a comma-separated list of objects.

Expand may be used on `GET`, `PATCH`, `POST`, `PUT` requests.

Important warning
It is highly recommended to use `expand` for single resources only. This operation will negatively affect performance on collections.

Example request containing multiple objects:


```yaml
?expand=recentInvoice,customer
```

Example response:


```yaml
'_embedded': ['recentInvoice': { ... }, 'customer': { ... }]
```