> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Success responses

When a request is successful, Paddle returns a data object or array with a 2xx HTTP response code. List endpoints return a data array and metadata object with pagination information.

---

The Paddle API returns requested entities in a `data` object or array when a response body is present. In most cases, it also returns a `meta` object with information about the request, including pagination information for list operations.

Success responses return a `2xx` response code.

{% callout type="info" %}
When there's [an error](https://developer.paddle.com/api-reference/about/errors.md), the API returns an `error` object instead. Errors return a `4xx` or `5xx` response code.
{% /callout %}

## List entities

When you successfully list entities, Paddle returns:

- A `data` array that includes a paginated list of requested entities.
- A `meta` object that includes `pagination` information.

The response code is `200`.

## Get an entity

When you successfully get an entity, Paddle returns:

- A `data` object with the requested entity.
- A `meta` object with information about the request.

The response code is `200`.

## Create an entity

When you successfully create an entity, Paddle returns:

- A `data` object with the created entity.
- A `meta` object with information about the request.

All the fields against the new entity are returned, including any generated or calculated fields. If you omitted optional fields, Paddle returns those with the default values.

The response code is `201`.

## Update an entity

The Paddle API generally uses the `PATCH` method to update entities.

When you successfully update an entity, Paddle returns:

- A `data` object with the updated entity.
- A `meta` object with information about the request.

All the fields against the updated entity are returned, including fields that you didn't change.

The response code is `200`.

## Delete an entity

Most entities can't be deleted. Instead, you can [archive](https://developer.paddle.com/api-reference/about/archived-entities.md) them.

For entities that can be deleted, no response is returned. The response code is `204`.