{"openapi":"3.1.0","info":{"title":"Spot Public Breeds API","version":"1.0.0","description":"Public developer API for Spot breeds data. All endpoints require an API key in the x-api-key header."},"servers":[{"url":"/api/public"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"statusCode":{"type":"integer"},"statusMessage":{"type":"string"}}}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/breeds":{"get":{"summary":"List breeds","description":"Returns dog or cat breeds with optional filters and pagination.","parameters":[{"name":"kind","in":"query","schema":{"type":"string","enum":["dogs","cats"]}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"temperament","in":"query","schema":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},{"name":"filters","in":"query","schema":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}}],"responses":{"200":{"description":"Breeds payload"},"401":{"description":"Missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/breeds/{id}":{"get":{"summary":"Get breed by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Breed details"},"404":{"description":"Not found"}}}},"/breeds/{id}/listings":{"get":{"summary":"Get listings for breed","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listings for breed"},"404":{"description":"Not found"}}}}}}