{"openapi":"3.1.0","info":{"title":"Dog Breeds & Images API","version":"1.0.0","description":"Dog-breed images and the full breed taxonomy via the open Dog CEO collection — no key. The breeds endpoint returns every breed with its sub-breeds (e.g. hound → afghan, basset, blood, …). The images endpoint fetches a batch of photos for a given breed and optional sub-breed, and the random endpoint pulls a batch of random dog photos from across all breeds. Real images straight from the Dog CEO dataset, with the breed list cached for speed — no key. 4 endpoints. Ideal for pet apps, placeholder imagery, breed pickers, quizzes and fun UI seeding.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/dog-api","description":"oanor gateway"}],"tags":[{"name":"Dogs"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/breeds":{"get":{"operationId":"get_v1_breeds","tags":["Dogs"],"summary":"All breeds & sub-breeds","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":108,"breeds":[{"breed":"affenpinscher","sub_breeds":[]},{"breed":"african","sub_breeds":["wild"]},{"breed":"airedale","sub_breeds":[]},{"breed":"akita","sub_breeds":[]},{"breed":"appenzeller","sub_breeds":[]},{"breed":"australian","sub_breeds":["kelpie","shepherd"]},{"breed":"bakharwal","sub_breeds":["indian"]},{"breed":"basenji","sub_breeds":[]},{"breed":"beagle","sub_breeds":[]},{"breed":"bluetick","sub_breeds":[]},{"breed":"borzoi","sub_breeds":[]},{"breed":"bouvier","sub_breeds":[]},{"breed":"boxer","sub_breeds":[]},{"breed":"brabancon","sub_breeds":[]},{"breed":"briard","sub_breeds":[]},{"breed":"buhund","sub_breeds":["norwegian"]},{"breed":"bulldog","sub_breeds":["boston","english","french"]},{"breed":"bullterrier","sub_breeds":["staffordshire"]},{"breed":"cattledog","sub_breeds":["australian"]},{"breed":"cavapoo","sub_breeds":[]},{"breed":"chihuahua","sub_breeds":[]},{"breed":"chippiparai","sub_breeds":["indian"]},{"breed":"chow","sub_breeds":[]},{"breed":"clumber","sub_breeds":[]},{"breed":"cockapoo","sub_breeds":[]},{"breed":"collie","sub_breeds":["border"]},{"breed":"coonhound","sub_breeds":[]},{"breed":"corgi","sub_breeds":["cardigan"]},{"breed":"cotondetulear","sub_breeds":[]},{"breed":"dachshund","sub_breeds":[]},{"breed":"dalmatian","sub_breeds":[]},{"breed":"dane","sub_breeds":["great"]},{"breed":"danish","sub_breeds":["swedish"]},{"breed":"deerhound","sub_breeds":["scottish"]},{"breed":"dhole","sub_breeds":[]},{"breed":"dingo","sub_breeds":[]},{"breed":"doberman","sub_breeds":[]},{"breed":"elkhound","sub_breeds":["norwegian"]},{"breed":"entlebucher","sub_breeds":[]},{"breed":"eskimo","sub_breeds":[]},{"breed":"finnish","sub_breeds":["lapphund"]},{"breed":"frise","sub_breeds":["bichon"]},{"breed":"gaddi","sub_breeds":["indian"]},{"breed":"german","sub_breeds":["shepherd"]},{"breed":"greyhound","sub_breeds":["indian","italian"]},{"breed":"groenendael","sub_breeds":[]},{"breed":"havanese","sub_breeds":[]},{"breed":"hound","sub_breeds":["afghan","basset","blood","english","ibizan","plott","walker"]},{"breed":"husky","sub_breeds":[]},{"breed":"keeshond","sub_breeds":[]},{"breed":"kelpie","sub_breeds":[]},{"breed":"kombai","sub_breeds":[]},{"breed":"komondor","sub_breeds":[]},{"breed":"kuvasz","sub_breeds":[]},{"breed":"labradoodle","sub_breeds":[]},{"breed":"labrador","sub_breeds":[]},{"breed":"leonberg","sub_breeds":[]},{"breed":"lhasa","sub_breeds":[]},{"breed":"malamute","sub_breeds":[]},{"breed":"malinois","sub_breeds":[]},{"breed":"maltese","sub_breeds":[]},{"breed":"mastiff","sub_breeds":["bull","english","indian","tibetan"]},{"breed":"mexicanhairless","sub_breeds":[]},{"breed":"mix","sub_breeds":[]},{"breed":"mountain","sub_breeds":["bernese","swiss"]},{"breed":"mudhol","sub_breeds":["indian"]},{"breed":"newfoundland","sub_breeds":[]},{"breed":"otterhound","sub_breeds":[]},{"breed":"ovcharka","sub_breeds":["caucasian"]},{"breed":"papillon","sub_breeds":[]},{"breed":"pariah","sub_breeds":["indian"]},{"breed":"pekinese","sub_breeds":[]},{"breed":"pembroke","sub_breeds":[]},{"breed":"pinscher","sub_breeds":["miniature"]},{"breed":"pitbull","sub_breeds":[]},{"breed":"pointer","sub_breeds":["german","germanlonghair"]},{"breed":"pomeranian","sub_breeds":[]},{"breed":"poodle","sub_breeds":["medium","miniature","standard","toy"]},{"breed":"pug","sub_breeds":[]},{"breed":"puggle","sub_breeds":[]},{"breed":"pyrenees","sub_breeds":[]},{"breed":"rajapalayam","sub_breeds":["indian"]},{"breed":"redbone","sub_breeds":[]},{"breed":"retriever","sub_breeds":["chesapeake","curly","flatcoated","golden"]},{"breed":"ridgeback","sub_breeds":["rhodesian"]},{"breed":"rottweiler","sub_breeds":[]},{"breed":"rough","sub_breeds":["collie"]},{"breed":"saluki","sub_breeds":[]},{"breed":"samoyed","sub_breeds":[]},{"breed":"schipperke","sub_breeds":[]},{"breed":"schnauzer","sub_breeds":["giant","miniature"]},{"breed":"segugio","sub_breeds":["italian"]},{"breed":"setter","sub_breeds":["english","gordon","irish"]},{"breed":"sharpei","sub_breeds":[]},{"breed":"sheepdog","sub_breeds":["english","indian","shetland"]},{"breed":"shiba","sub_breeds":[]},{"breed":"shihtzu","sub_breeds":[]},{"breed":"spaniel","sub_breeds":["blenheim","brittany","cocker","irish","japanese","sussex","welsh"]},{"breed":"spitz","sub_breeds":["indian","japanese"]},{"breed":"springer","sub_breeds":["english"]},{"breed":"stbernard","sub_breeds":[]},{"breed":"terrier","sub_breeds":["american","andalusian","australian","bedlington","border","boston","cairn","dandie","fox","irish","kerryblue","lakeland","norfolk","norwich","patterdale","russell","scottish","sealyham","silky","tibetan","toy","welsh","westhighland","wheaten","yorkshire"]},{"breed":"tervuren","sub_breeds":[]},{"breed":"vizsla","sub_breeds":[]},{"breed":"waterdog","sub_breeds":["spanish"]},{"breed":"weimaraner","sub_breeds":[]},{"breed":"whippet","sub_breeds":[]},{"breed":"wolfhound","sub_breeds":["irish"]}]},"meta":{"timestamp":"2026-06-08T09:48:47.646Z","request_id":"8ac26903-b049-4e3c-9f15-476a4b85dfa6"},"status":"ok","message":"Breeds retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/images":{"get":{"operationId":"get_v1_images","tags":["Dogs"],"summary":"Images for a breed","description":"","parameters":[{"name":"breed","in":"query","required":true,"description":"Breed name (see /v1/breeds)","schema":{"type":"string"},"example":"hound"},{"name":"sub","in":"query","required":false,"description":"Sub-breed (e.g. afghan)","schema":{"type":"string"},"example":"afghan"},{"name":"count","in":"query","required":false,"description":"Number of images (1-50, default 12)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"breed":"hound","count":5,"images":["https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg","https://images.dog.ceo/breeds/hound-afghan/n02088094_173.jpg","https://images.dog.ceo/breeds/hound-afghan/n02088094_3582.jpg","https://images.dog.ceo/breeds/hound-afghan/n02088094_6241.jpg","https://images.dog.ceo/breeds/hound-afghan/n02088094_7683.jpg"],"sub_breed":"afghan"},"meta":{"timestamp":"2026-06-08T09:48:47.869Z","request_id":"bfda4cb8-bb08-4ca6-abef-41611fadae77"},"status":"ok","message":"Images retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Dogs"],"summary":"Random dog images","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"Number of images (1-50, default 1)","schema":{"type":"string"},"example":"3"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"images":["https://images.dog.ceo/breeds/bullterrier-staffordshire/n02093256_14914.jpg","https://images.dog.ceo/breeds/setter-gordon/n02101006_134.jpg","https://images.dog.ceo/breeds/bakharwal-indian/Bakharwal.jpg"]},"meta":{"timestamp":"2026-06-08T09:48:48.036Z","request_id":"923d7c4a-e031-4ebb-9fb7-e0a79ee2fdb7"},"status":"ok","message":"Random images retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"dog-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/breeds":"All breeds with their sub-breeds.","GET /v1/images":"Images for a breed (breed=, sub=optional, count=1-50, default 12).","GET /v1/random":"Random dog images (count=1-50, default 1)."},"description":"Dog-breed images and taxonomy via the open Dog CEO API: list every breed with its sub-breeds; fetch a batch of images for a breed (and optional sub-breed); or pull random dog images. Real photos straight from the Dog CEO collection, no key."},"meta":{"timestamp":"2026-06-08T09:48:48.164Z","request_id":"c983244d-e250-4572-8efc-9b3ea21bc9c5"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6600,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":650,"monthly_call_quota":88500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":551500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7200,"monthly_call_quota":2700000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/dog-api"}