{
  "openapi": "3.1.0",
  "info": {
    "title": "Dogs API",
    "version": "1.0.0",
    "description": "296 AKC-recognised dog breeds with 14 scored traits, size, coat, colours, history and popularity since 2015.\n\nDetailed reference data for 296 AKC-recognized dog breeds — breed group, origin, nicknames, year recognized, height, weight and life-expectancy ranges, size class, 14 behavioural and care trait scores (1–5) with descriptions (energy, shedding, trainability, barking, child- and dog-friendliness, and more), coat type and length, official colors with breed-standard flags, temperament, AKC popularity rank with 2015–2025 history, plus a written description, breed history and breed-standard sections. Filter by name, group, origin, size, coat type and coat length. Self-hosted dataset scraped from akc.org — no third-party calls.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/dogs.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/dogs"
  },
  "servers": [
    {
      "url": "https://api-dogs.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Data",
      "description": "Dogs API belongs to the Data category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/breeds/groups": {
      "get": {
        "operationId": "breedGroups",
        "summary": "Breed Groups",
        "description": "Breed Groups endpoint of the Dogs API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/dogs/breed-groups"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 9,
                  "groups": [
                    {
                      "group": "Foundation Stock Service",
                      "count": 74
                    },
                    {
                      "group": "Herding Group",
                      "count": 33
                    },
                    {
                      "group": "Hound Group",
                      "count": 33
                    },
                    {
                      "group": "Sporting Group",
                      "count": 33
                    },
                    {
                      "group": "Toy Group",
                      "count": 24
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/breeds/{slug}": {
      "get": {
        "operationId": "getBreed",
        "summary": "Get Breed",
        "description": "Get Breed endpoint of the Dogs API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/dogs/get-breed"
        },
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "chesapeake-bay-retriever"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "id": 24534,
                  "slug": "golden-retriever",
                  "name": "Golden Retriever",
                  "nicknames": [
                    "Golden"
                  ],
                  "breedGroup": "Sporting Group",
                  "origin": "Scotland",
                  "popularityRank": 3,
                  "lifeExpectancyYears": {
                    "min": 10,
                    "max": 12
                  },
                  "heightInches": {
                    "min": 21.5,
                    "max": 24
                  },
                  "weightPounds": {
                    "min": 55,
                    "max": 75
                  },
                  "size": "Large",
                  "temperament": [
                    "intelligent",
                    "friendly",
                    "devoted"
                  ],
                  "coatType": [
                    "Double"
                  ],
                  "coatLength": [
                    "Medium"
                  ],
                  "image": "https://www.akc.org/wp-content/uploads/2017/11/Golden-Retriever-standing-outdoors.jpg",
                  "yearRecognized": 1925,
                  "traits": {
                    "adaptability_level": {
                      "score": 5,
                      "name": "Adaptability Level",
                      "description": "How easily a breed handles change...",
                      "low": "Lives For Routine",
                      "high": "Highly Adaptable"
                    },
                    "affectionate_with_family": {
                      "score": 5,
                      "name": "Affectionate With Family",
                      "description": "How affectionate a breed is likely to be...",
                      "low": "Independent",
                      "high": "Lovey-Dovey"
                    },
                    "energy_level": {
                      "score": 3,
                      "name": "Energy Level",
                      "description": "The amount of exercise and mental stimulation...",
                      "low": "Couch Potato",
                      "high": "High Energy"
                    }
                  },
                  "colors": [
                    {
                      "name": "Dark Golden",
                      "standard": true
                    },
                    {
                      "name": "Golden",
                      "standard": true
                    },
                    {
                      "name": "Light Golden",
                      "standard": true
                    }
                  ],
                  "popularityHistory": {
                    "2015": 3,
                    "2020": 4,
                    "2025": 3
                  },
                  "relatedBreeds": [
                    "Labrador Retriever",
                    "Flat-Coated Retriever"
                  ],
                  "description": "The Golden Retriever, an exuberant Scottish gundog of great beauty, stands among America's most popular dog breeds...",
                  "history": "<p>The most important name in the early history of the Golden Retriever is Dudley Marjoribanks...</p>",
                  "healthDescription": "Owning a dog is not just a privilege; it's a responsibility...",
                  "standardSections": [
                    {
                      "title": "General Appearance",
                      "description": "A symmetrical, powerful, active dog, sound and well put together..."
                    }
                  ],
                  "akcUrl": "https://www.akc.org/dog-breeds/golden-retriever/"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/breeds": {
      "get": {
        "operationId": "listBreeds",
        "summary": "List Breeds",
        "description": "List Breeds endpoint of the Dogs API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/dogs/list-breeds"
        },
        "parameters": [
          {
            "name": "coatLength",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Medium"
          },
          {
            "name": "coatType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Hairless"
          },
          {
            "name": "group",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Toy"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "origin",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Scotland"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "retriever"
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "XSmall"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "total": 296,
                  "page": 1,
                  "limit": 20,
                  "count": 1,
                  "results": [
                    {
                      "id": 23195,
                      "slug": "affenpinscher",
                      "name": "Affenpinscher",
                      "nicknames": [
                        "Affen",
                        "Monkey Dog"
                      ],
                      "breedGroup": "Toy Group",
                      "origin": "Germany",
                      "popularityRank": 153,
                      "lifeExpectancyYears": {
                        "min": 12,
                        "max": 15
                      },
                      "heightInches": {
                        "min": 9,
                        "max": 11.5
                      },
                      "weightPounds": {
                        "min": 7,
                        "max": 10
                      },
                      "size": "XSmall",
                      "temperament": [
                        "confident",
                        "famously funny",
                        "fearless"
                      ],
                      "coatType": [
                        "Wiry"
                      ],
                      "coatLength": [
                        "Short",
                        "Medium"
                      ],
                      "image": "https://www.akc.org/wp-content/uploads/2017/11/Affenpinscher-running-outdoors.jpg"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/breeds/random": {
      "get": {
        "operationId": "randomBreeds",
        "summary": "Random Breeds",
        "description": "Random Breeds endpoint of the Dogs API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/dogs/random-breeds"
        },
        "parameters": [
          {
            "name": "amount",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "3"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 2,
                  "results": [
                    {
                      "slug": "whippet",
                      "name": "Whippet",
                      "breedGroup": "Hound Group",
                      "size": "Medium",
                      "temperament": [
                        "affectionate",
                        "playful",
                        "calm"
                      ]
                    },
                    {
                      "slug": "akita",
                      "name": "Akita",
                      "breedGroup": "Working Group",
                      "size": "Large",
                      "temperament": [
                        "courageous",
                        "dignified",
                        "profoundly loyal"
                      ]
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}