---
title: API Documentation
slug: dev-docs/api-documentation
description: Discover detailed information on the Swagger Petstore API in this document, covering authentication, available endpoints, code examples, responses, rate limits, and more. Explore how to add a new pet to the store using the API, accompanied by code example
docTags: 
createdAt: 2023-04-07T11:01:37.000Z
---

This document provides detailed information on the Swagger Petstore API, including endpoints, authentication, and any relevant parameters.

## Authentication

The Swagger Petstore API does not require authentication.

## Endpoints

The following endpoint is available in the Swagger Petstore API:

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "/pet",
  "name": "Add a New Pet to the Store",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "kind": "optional",
        "name": "Parameter name",
        "type": "Object",
        "children": [
          {
            "kind": "optional",
            "name": "id",
            "type": "Integer",
            "description": "unique identifier for the pet (optional)"
          },
          {
            "kind": "optional",
            "name": "name",
            "type": "string",
            "description": "name of the pet"
          },
          {
            "kind": "optional",
            "name": "photoUrls",
            "type": "Array",
            "description": "URLs to photos of the pet"
          },
          {
            "kind": "optional",
            "name": "tags",
            "type": "Array",
            "description": "tags assigned to the pet (optional)"
          },
          {
            "kind": "optional",
            "name": "status",
            "type": "String",
            "description": "pet status in the store\n"
          }
        ],
        "description": "Pet object that needs to be added to the store"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "bjlJi4J_fZWTsSVwbt25h",
        "code": "{\n  \"id\": 12345,\n  \"name\": \"Fluffy\",\n  \"photoUrls\": [\n    \"https://example.com/fluffy1.jpg\",\n    \"https://example.com/fluffy2.jpg\"\n  ],\n  \"tags\": [\n    {\n      \"id\": 1,\n      \"name\": \"cute\"\n    }\n  ],\n  \"status\": \"available\"\n}\n",
        "language": "200",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "bjlJi4J_fZWTsSVwbt25h"
  },
  "examples": {
    "languages": [
      {
        "id": "V9SD6yGEPAesqPF3_m-q2",
        "code": "POST /pet\nHost: petstore.swagger.io\nContent-Type: application/json\n{\n  \"id\": 12345,\n  \"name\": \"Fluffy\",\n  \"photoUrls\": [\n    \"https://example.com/fluffy1.jpg\",\n    \"https://example.com/fluffy2.jpg\"\n  ],\n  \"tags\": [\n    {\n      \"id\": 1,\n      \"name\": \"cute\"\n    }\n  ],\n  \"status\": \"available\"\n}\n",
        "language": "curl",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "V9SD6yGEPAesqPF3_m-q2"
  },
  "description": "This endpoint allows you to add a new pet to the store.",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  }
}
```
:::

## Rate Limits

The Swagger Petstore API does not have rate limits.

## Resources

For additional information on using the Swagger Petstore API, please refer to the following resources:

- [Swagger Petstore API Documentation](https://petstore.swagger.io/#/pet)
- [Swagger Petstore API GitHub Repository](https://github.com/swagger-api/swagger-petstore)

## Conclusion

Thank you for using the Swagger Petstore API. If you have any questions or encounter any issues, please reach out to us on \[Communication Platform].

***

## SwaggerUI Example

:::Swagger
```json
{
  "headers": [],
  "jsonFileLocation": "https://petstore.swagger.io/v2/swagger.json"
}
```
:::