{"openapi":"3.1.0","info":{"title":"Tarot API","version":"1.0.0","description":"The complete 78-card tarot deck as an API — 22 Major Arcana and 56 Minor Arcana across the four suits (Wands, Cups, Swords and Pentacles). Look up any card by id or name (e.g. The Fool, The Lovers, Ace of Cups) for its upright and reversed meanings and the classic Rider-Waite description, search the whole deck by keyword or theme (e.g. love), browse a single minor suit, or draw a spread of random cards for an instant reading. Each card carries its arcana type, suit, numeric value and both interpretations. Ideal for tarot and astrology apps, daily-card widgets, divination and journaling tools, games and content sites.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tarot-api","description":"oanor gateway"}],"tags":[{"name":"Tarot"},{"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/card":{"get":{"operationId":"get_v1_card","tags":["Tarot"],"summary":"A card by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Card id, e.g. ar00 (The Fool) or wands01","schema":{"type":"string"},"example":"ar00"},{"name":"name","in":"query","required":false,"description":"Card name, e.g. The Lovers","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/cards":{"get":{"operationId":"get_v1_cards","tags":["Tarot"],"summary":"The whole deck, or one minor suit","description":"","parameters":[{"name":"suit","in":"query","required":false,"description":"wands | cups | swords | pentacles (omit for all 78)","schema":{"type":"string"},"example":"cups"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/draw":{"get":{"operationId":"get_v1_draw","tags":["Tarot"],"summary":"Draw random cards for a reading","description":"","parameters":[{"name":"n","in":"query","required":false,"description":"How many cards (1-10, default 3)","schema":{"type":"string"},"example":"3"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/search":{"get":{"operationId":"get_v1_search","tags":["Tarot"],"summary":"Search cards by name or meaning","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Keyword or theme, e.g. love","schema":{"type":"string"},"example":"love"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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":"Suits & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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":11500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":270,"monthly_call_quota":165000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":900,"monthly_call_quota":710000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2870,"monthly_call_quota":2920000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tarot-api"}