openapi: 3.1.0 info: title: Pet Store API version: 1.0.0 description: A sample API that uses a petstore as an example to demonstrate features in the OpenAPI 3.1 specification servers: - url: https://petstore.swagger.io/v2 description: Petstore server paths: /pets: get: summary: List all pets operationId: listPets tags: - pets parameters: - name: limit in: query description: How many items to return at one time (max 100) required: false schema: type: integer maximum: 100 format: int32 responses: '200': description: A paged array of pets content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Pet' components: schemas: Pet: type: object required: - id - name properties: id: type: integer format: int64 name: type: string tag: type: string