---
title: "Animal Facts API"
url: "https://sg-dev-1.scripture.sh/apis/animal-facts-api-1/versions/cb120a4d-754c-446d-bfae-b856ae097070"
---

# Animal Facts API

OpenAPI specification document.

```json
{"openapi":"3.1.0","info":{"title":"Animal Facts API","version":"1.0.0","description":"API for retrieving facts and breeds about cats and dogs."},"servers":[{"url":"https://api.example.com","description":"Production server"}],"tags":[{"name":"Cats","description":"Operations related to cats"},{"name":"Dogs","description":"Operations related to dogs"},{"name":"Health","description":"Health check operations"}],"paths":{"/cats/breeds":{"get":{"summary":"List cat breeds","description":"Returns a list of cat breeds with pagination.","operationId":"listCatBreeds","tags":["Cats"],"parameters":[{"name":"limit","in":"query","description":"Maximum number of items to return","schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","description":"Number of items to skip for pagination","schema":{"type":"integer","format":"int32","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Breed"}},"meta":{"type":"object","properties":{"page":{"type":"object","properties":{"offset":{"type":"integer","description":"The offset used for pagination."},"limit":{"type":"integer","description":"The limit used for pagination."},"total":{"type":"integer","description":"The total number of items available."},"estimated_total":{"type":"boolean","description":"Indicates if the total is an estimate."}}}}}}}}}}}}},"/cats/facts":{"get":{"summary":"List cat facts","description":"Returns a list of interesting cat facts with pagination.","operationId":"listCatFacts","tags":["Cats"],"parameters":[{"name":"limit","in":"query","description":"Maximum number of items to return","schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","description":"Number of items to skip for pagination","schema":{"type":"integer","format":"int32","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Fact"}},"meta":{"type":"object","properties":{"page":{"type":"object","properties":{"offset":{"type":"integer","description":"The offset used for pagination."},"limit":{"type":"integer","description":"The limit used for pagination."},"total":{"type":"integer","description":"The total number of items available."},"estimated_total":{"type":"boolean","description":"Indicates if the total is an estimate."}}}}}}}}}}}}},"/dogs/breeds":{"get":{"summary":"List dog breeds","description":"Returns a list of dog breeds with pagination.","operationId":"listDogBreeds","tags":["Dogs"],"parameters":[{"name":"limit","in":"query","description":"Maximum number of items to return","schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","description":"Number of items to skip for pagination","schema":{"type":"integer","format":"int32","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Breed"}},"meta":{"type":"object","properties":{"page":{"type":"object","properties":{"offset":{"type":"integer","description":"The offset used for pagination."},"limit":{"type":"integer","description":"The limit used for pagination."},"total":{"type":"integer","description":"The total number of items available."},"estimated_total":{"type":"boolean","description":"Indicates if the total is an estimate."}}}}}}}}}}}}},"/dogs/facts":{"get":{"summary":"List dog facts","description":"Returns a list of interesting dog facts with pagination.","operationId":"listDogFacts","tags":["Dogs"],"parameters":[{"name":"limit","in":"query","description":"Maximum number of items to return","schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","description":"Number of items to skip for pagination","schema":{"type":"integer","format":"int32","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Fact"}},"meta":{"type":"object","properties":{"page":{"type":"object","properties":{"offset":{"type":"integer","description":"The offset used for pagination."},"limit":{"type":"integer","description":"The limit used for pagination."},"total":{"type":"integer","description":"The total number of items available."},"estimated_total":{"type":"boolean","description":"Indicates if the total is an estimate."}}}}}}}}}}}}},"/v1/health":{"get":{"summary":"Health check endpoint","description":"Returns the health status of the API.","operationId":"getHealth","tags":["Health"],"responses":{"200":{"description":"API is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"The status of the API.","example":"healthy"}}}}}}}}}},"components":{"schemas":{"Breed":{"type":"object","properties":{"name":{"type":"string","description":"The name of the breed.","example":"Siamese"},"origin":{"type":"string","description":"The origin of the breed.","example":"Thailand"}}},"Fact":{"type":"string","description":"An interesting fact.","example":"Cats can make over 100 different sounds."}}}}
```