{"openapi":"3.0.3","info":{"title":"Deckaura Daily Horoscope API","description":"Free, no-auth daily horoscope API for all 12 zodiac signs. Returns a general overview, love and career guidance, a lucky number, a lucky color and a 1-5 rating, refreshed daily at midnight UTC. Maintained by Deckaura (https://deckaura.com).","version":"1.0.0","termsOfService":"https://deckaura.com/pages/terms-of-service","contact":{"name":"Deckaura","url":"https://deckaura.com","email":"hello@deckaura.com"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"x-logo":{"url":"https://deckaura.com/favicon.ico"}},"externalDocs":{"description":"API docs & more free tools","url":"https://horoscope.deckaura.com/api"},"servers":[{"url":"https://horoscope.deckaura.com","description":"Production"}],"tags":[{"name":"horoscope","description":"Daily zodiac horoscopes"}],"paths":{"/api/daily/{sign}":{"get":{"tags":["horoscope"],"summary":"Daily horoscope for one zodiac sign","description":"Returns today's horoscope for the given zodiac sign.","operationId":"getDailyHoroscope","parameters":[{"name":"sign","in":"path","required":true,"description":"Lowercase English zodiac sign.","schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces"]}}],"responses":{"200":{"description":"Daily horoscope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyHoroscope"},"example":{"sign":"Leo","symbol":"♌","date":"2026-07-01","overview":"Today brings fresh energy for Leo. Trust your instincts and stay open to new possibilities.","love":"Connection deepens with those who matter most.","career":"A productive day awaits if you stay focused on priorities.","lucky_number":49,"lucky_color":"Gold","rating":5,"source":"Deckaura Daily Horoscope","website":"https://deckaura.com"}}}},"400":{"description":"Invalid zodiac sign","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/daily":{"get":{"tags":["horoscope"],"summary":"Daily horoscopes for all 12 signs","operationId":"getAllDailyHoroscopes","responses":{"200":{"description":"All signs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllHoroscopes"}}}}}}}},"components":{"schemas":{"DailyHoroscope":{"type":"object","properties":{"sign":{"type":"string","example":"Leo"},"symbol":{"type":"string","example":"♌"},"date":{"type":"string","format":"date","example":"2026-07-01"},"overview":{"type":"string"},"love":{"type":"string"},"career":{"type":"string"},"lucky_number":{"type":"integer","minimum":1,"maximum":99,"example":49},"lucky_color":{"type":"string","example":"Gold"},"rating":{"type":"integer","minimum":1,"maximum":5,"example":5},"source":{"type":"string","example":"Deckaura Daily Horoscope"},"website":{"type":"string","format":"uri","example":"https://deckaura.com"}}},"AllHoroscopes":{"type":"object","properties":{"date":{"type":"string","format":"date"},"horoscopes":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/DailyHoroscope"}},"source":{"type":"string","example":"Deckaura"}}},"Error":{"type":"object","properties":{"error":{"type":"string","example":"Invalid sign"}}}}}}