# Responses
Document API response structures and fields with Mintlify-compatible response components.
Source: /docs/components/responses
Last modified: 2026-06-20
Use `Responses` to group the fields returned by an API call. It is the Mintlify-compatible container for `ResponseField` rows, nested response objects, and response examples.

## Basic response field


- `response` (string; required):
  A response field example.


```mdx title="response-field-basic.mdx"

- `response` (string; required):
  A response field example.


```


### Offer response


- `totals` (object):
    Calculated totals returned for a checkout session.

- `totals.total` (integer):
      Final total in the smallest currency unit.


- `offer` (object; required):
    The offer returned by a catalog, checkout, or API call.

- `offer.id` (string; required):
      Stable offer identifier.


- `offer.slug` (string; optional):
      Public slug when the offer has a hosted page.


- `offer.components` (array<object): " expandable>
      Checkout blocks such as order bumps, add-ons, and save offers.


- `request_id` (string; optional):
    Trace identifier returned for support and debugging.


```mdx title="responses.mdx"

### Offer response


- `totals` (object):
    Calculated totals returned for a checkout session.


- `offer` (object; required):
    The offer returned by the API.

- `offer.id` (string; required):
      Stable offer identifier.


```


### Response example


### 200 offer


    ```json title="Offer response"
    { "offer": { "id": "off_123" }, "request_id": "req_abc" }
    ```


  - [ResponseField props](/docs/components/response-fields): Document response object shapes, nested fields, and returned data.
  - [API examples](/docs/components/api-fields-examples): Pair request and response examples with endpoint-aware docs pages.