swagger: "2.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 Swagger 2.0 specification host: petstore.swagger.io basePath: /v2 schemes: - https - http 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 type: integer maximum: 100 responses: 200: description: A paged array of pets schema: type: object properties: data: type: array items: $ref: '#/definitions/Pet' definitions: Pet: type: object required: - id - name properties: id: type: integer format: int64 name: type: string tag: type: string