
[[_paths]]
== Paths

[[_getpetbyid]]
=== Find pet by ID
....
GET /pets/{petId}
....


==== Description
Returns a pet when ID &lt; 10. ID &gt; 10 or nonintegers will simulate API error conditions


==== Parameters

[options="header", cols=".^2a,.^3a,.^9a,.^4a"]
|===
|Type|Name|Description|Schema
|**Path**|**petId** +
__required__|ID of pet that needs to be fetched|integer (int64)
|===


==== Responses

[options="header", cols=".^2a,.^14a,.^4a"]
|===
|HTTP Code|Description|Schema
|**200**|successful operation +
**Headers** :  +
`X-Rate-Limit-Limit` (string) : The number of allowed requests in the current period. **Default** : `"20"` +
`X-Rate-Limit-Remaining` (integer) : The number of remaining requests in the current period. +
This is an important value !. +
`X-Rate-Limit-Reset` (boolean) :  **Default** : `false`|<<_pet,Pet>>
|**400**|Invalid ID supplied|No Content
|**404**|Page not found (override) +
**Headers** :  +
`X-Rate-Limit-Limit` (string) : The number of allowed requests in the current period. **Default** : `"20"` +
`X-Rate-Limit-Remaining` (integer) : The number of remaining requests in the current period. +
This is an important value !. +
`X-Rate-Limit-Reset` (boolean) :  **Default** : `false` +
`Nothing` (integer) +
`DottedDescription` (string) : This description is terminated with a dot. **Default** : `"20"`|No Content
|===


==== Produces

* `application/json`
* `application/xml`


==== Tags

* pet


==== Security

[options="header", cols=".^3a,.^4a,.^13a"]
|===
|Type|Name|Scopes
|**apiKey**|**<<_api_key,api_key>>**|
|**oauth2**|**<<_petstore_auth,petstore_auth>>**|write_pets,read_pets
|===



