mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ricardo Nunez
40d2e2cd2d
* Add proper language support for syntax highlighting to all code blocks * Camel case inline code
32 lines
916 B
Plaintext
32 lines
916 B
Plaintext
---
|
|
title: "Multiple responses"
|
|
description: "Show response variations for the same endpoint"
|
|
---
|
|
|
|
If your API returns different responses based on input parameters, user context, or other conditions of the request, you can document multiple response examples with the `examples` property.
|
|
|
|
This property can be added to any response and has the following schema.
|
|
|
|
```yaml
|
|
responses:
|
|
"200":
|
|
description: Successful response
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: "#/components/schemas/YourResponseSchema"
|
|
examples:
|
|
us:
|
|
summary: Response for United States
|
|
value:
|
|
countryCode: "US"
|
|
currencyCode: "USD"
|
|
taxRate: 0.0825
|
|
gb:
|
|
summary: Response for United Kingdom
|
|
value:
|
|
countryCode: "GB"
|
|
currencyCode: "GBP"
|
|
taxRate: 0.20
|
|
```
|