{"openapi":"3.1.0","info":{"title":"Animals API","version":"1.0.0","description":"Dogs and cats as a single friendly API. List every dog breed and its sub-breeds and pull dog photos (e.g. breed=hound or hound/afghan, up to 10 at once), browse 60+ cat breeds with rich metadata — temperament, country of origin, life span, weight and child/dog-friendliness scores — pull cat photos, and grab a random cat fact. Three reliable, key-less open sources (dog.ceo, TheCatAPI, catfact.ninja) behind one clean envelope. Perfect for pet adoption and veterinary apps, kids and education content, Discord/Telegram bots, placeholder imagery, quizzes and any product that needs a quick hit of dogs and cats.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/animals-api","description":"oanor gateway"}],"tags":[{"name":"Dogs"},{"name":"Cats"},{"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/dog/breeds":{"get":{"operationId":"get_v1_dog_breeds","tags":["Dogs"],"summary":"Every dog breed and its 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-01T00:04:41.071Z","request_id":"81136b93-cd87-4e95-84ae-a782a3912271"},"status":"ok","message":"Dog breeds retrieved","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/dog/image":{"get":{"operationId":"get_v1_dog_image","tags":["Dogs"],"summary":"Random dog photo(s), optionally by breed","description":"","parameters":[{"name":"breed","in":"query","required":false,"description":"Breed or breed/sub-breed, e.g. hound or hound/afghan","schema":{"type":"string"},"example":"hound"},{"name":"count","in":"query","required":false,"description":"How many photos (1-10, default 1)","schema":{"type":"string"},"example":"3"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"breed":"hound","count":3,"images":["https://images.dog.ceo/breeds/hound-afghan/n02088094_4230.jpg","https://images.dog.ceo/breeds/hound-afghan/n02088094_7683.jpg","https://images.dog.ceo/breeds/hound-walker/n02089867_1599.jpg"]},"meta":{"timestamp":"2026-06-01T00:04:41.192Z","request_id":"0dc92b69-4b46-43cd-b39d-149bdee3e642"},"status":"ok","message":"Dog image retrieved","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/cat/breeds":{"get":{"operationId":"get_v1_cat_breeds","tags":["Cats"],"summary":"Cat breeds with metadata (searchable)","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search name / origin / temperament, e.g. siamese","schema":{"type":"string"},"example":"siamese"},{"name":"limit","in":"query","required":false,"description":"Max breeds (1-100, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"siamese","total":1,"breeds":[{"id":"siam","name":"Siamese","indoor":false,"origin":"Thailand","weight":"4 - 7 kg","hairless":false,"life_span":"12 - 15","description":"While Siamese cats are extremely fond of their people, they will follow you around and supervise your every move, being talkative and opinionated. They are a demanding and social cat, that do not like being left alone for long periods.","temperament":"Active, Agile, Clever, Sociable, Loving, Energetic","dog_friendly":5,"energy_level":5,"intelligence":5,"wikipedia_url":"https://en.wikipedia.org/wiki/Siamese_(cat)","child_friendly":4,"affection_level":5,"reference_image_id":"ai6Jps4sx"}]},"meta":{"timestamp":"2026-06-01T00:04:41.604Z","request_id":"479c7681-9c5a-4947-862e-166e95fd9e18"},"status":"ok","message":"Cat breeds retrieved","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/cat/fact":{"get":{"operationId":"get_v1_cat_fact","tags":["Cats"],"summary":"A random cat fact","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fact":"Cat families usually play best in even numbers. Cats and kittens should be acquired in pairs whenever possible.","length":111},"meta":{"timestamp":"2026-06-01T00:04:41.843Z","request_id":"f4736800-7b5d-4a4e-8b4b-1b82098e16b2"},"status":"ok","message":"Cat fact retrieved","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/cat/image":{"get":{"operationId":"get_v1_cat_image","tags":["Cats"],"summary":"Random cat photo(s)","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many photos (1-10, default 1)","schema":{"type":"string"},"example":"3"},{"name":"breed_id","in":"query","required":false,"description":"Filter by TheCatAPI breed id, e.g. beng","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"images":[{"id":"41e","url":"https://cdn2.thecatapi.com/images/41e.gif","width":275,"height":189},{"id":"4jh","url":"https://cdn2.thecatapi.com/images/4jh.gif","width":478,"height":334},{"id":"apn","url":"https://cdn2.thecatapi.com/images/apn.jpg","width":612,"height":612}]},"meta":{"timestamp":"2026-06-01T00:04:42.108Z","request_id":"e0e77067-c6f4-4544-8e7c-e9e906614902"},"status":"ok","message":"Cat image retrieved","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":"Sources & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Dogs & cats. /v1/dog/breeds = all dog breeds + sub-breeds; /v1/dog/image = random dog photo(s) (breed=hound or hound/afghan, count up to 10); /v1/cat/breeds = cat breeds with temperament/origin/life-span/traits (q= to search); /v1/cat/image = random cat photo(s) (count, optional breed_id); /v1/cat/fact = a random cat fact. All upstreams are key-less.","sources":{"cats":"TheCatAPI (thecatapi.com)","dogs":"dog.ceo","cat_facts":"catfact.ninja"},"endpoints":["/v1/dog/breeds","/v1/dog/image","/v1/cat/breeds","/v1/cat/image","/v1/cat/fact","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:42.175Z","request_id":"60c5a9c7-2792-4c47-bd84-d260cf7c5c12"},"status":"ok","message":"Meta retrieved","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":5000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":390,"monthly_call_quota":80000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1190,"monthly_call_quota":400000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3490,"monthly_call_quota":2000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/animals-api"}