{"openapi":"3.1.0","info":{"title":"littlebook API","version":"0.2.0"},"paths":{"/v1/profile":{"post":{"summary":"Natal cards, rulers and suits","operationId":"post_profile_v1_profile_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cycles":{"post":{"summary":"Card of each cycle at a date","operationId":"post_cycles_v1_cycles_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CyclesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CyclesOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/timeline":{"post":{"summary":"Cards of a cycle over a date range","operationId":"post_timeline_v1_timeline_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelineRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelineOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search/card-dates":{"post":{"summary":"When a card falls in a cycle","operationId":"post_search_v1_search_card_dates_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spreads/current":{"post":{"summary":"Tableau of a cycle at a date, with the birthday card position","operationId":"post_current_spread_v1_spreads_current_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpreadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentSpreadOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/relation":{"post":{"summary":"Natal cards in common, and both positions in the current tableaux","operationId":"post_relation_v1_relation_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spreads/{index}":{"get":{"summary":"Tableau 0-89 (index + 1 quadratures)","operationId":"get_spread_v1_spreads__index__get","parameters":[{"name":"index","in":"path","required":true,"schema":{"type":"integer","title":"Index"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Spread"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spreads/{index}/cards/{card_id}":{"get":{"summary":"A card in tableau 0-89: its place, environment and displacement cards","operationId":"get_card_in_tableau_v1_spreads__index__cards__card_id__get","parameters":[{"name":"index","in":"path","required":true,"schema":{"type":"integer","title":"Index"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","title":"Card Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardInTableauOut"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cards":{"get":{"summary":"The 52 cards, by solar value","operationId":"get_cards_v1_cards_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CardDetail"},"title":"Response Get Cards V1 Cards Get"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cards/{card_id}":{"get":{"summary":"One card by id (KS, 10H, AD)","operationId":"get_card_v1_cards__card_id__get","parameters":[{"name":"card_id","in":"path","required":true,"schema":{"type":"string","title":"Card Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardDetail"}}}},"400":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"401":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"403":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"404":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"429":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"503":{"description":"error","content":{"application/json":{"example":{"error":"invalid_request","message":"profile.birthdate: Input should be a valid date","details":[{"field":"profile.birthdate","problem":"Input should be a valid date"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Candidate":{"properties":{"sign":{"type":"string","title":"Sign"},"decanate":{"type":"integer","title":"Decanate"},"planetary_ruler":{"items":{"type":"string"},"type":"array","title":"Planetary Ruler"},"decanate_ruler":{"type":"string","title":"Decanate Ruler"},"planetary_ruling_cards":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Planetary Ruling Cards"},"decanate_ruling_cards":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Decanate Ruling Cards"}},"type":"object","required":["sign","decanate","planetary_ruler","decanate_ruler","planetary_ruling_cards","decanate_ruling_cards"],"title":"Candidate"},"Card":{"properties":{"id":{"type":"string","title":"Id","description":"stable id, e.g. KS"},"name_en":{"type":"string","title":"Name En"},"name_fr":{"type":"string","title":"Name Fr"},"symbol":{"type":"string","title":"Symbol","description":"e.g. K ♠"}},"type":"object","required":["id","name_en","name_fr","symbol"],"title":"Card"},"CardDetail":{"properties":{"id":{"type":"string","title":"Id","description":"stable id, e.g. KS"},"name_en":{"type":"string","title":"Name En"},"name_fr":{"type":"string","title":"Name Fr"},"symbol":{"type":"string","title":"Symbol","description":"e.g. K ♠"},"solar_value":{"type":"integer","title":"Solar Value","description":"1 (Ace of Hearts) to 52 (King of Spades)"},"spirit_value":{"type":"integer","title":"Spirit Value"}},"type":"object","required":["id","name_en","name_fr","symbol","solar_value","spirit_value"],"title":"CardDetail"},"CardInTableau":{"properties":{"id":{"type":"string","title":"Id","description":"stable id, e.g. KS"},"name_en":{"type":"string","title":"Name En"},"name_fr":{"type":"string","title":"Name Fr"},"symbol":{"type":"string","title":"Symbol","description":"e.g. K ♠"},"line":{"type":"integer","title":"Line","description":"0 = crown line (3 cards), 1-7 = Mercury to Neptune"},"column":{"type":"integer","title":"Column"},"planets":{"items":{"type":"string"},"type":"array","title":"Planets","description":"[column planet, line planet], or [Crown n, Sun] on the crown line"},"environment_card":{"$ref":"#/components/schemas/Card","description":"the card of this tableau at the place this card holds in the life spread"},"displacement_card":{"$ref":"#/components/schemas/Card","description":"the card of the life spread at the place this card holds in this tableau (the first karma card in tableau 89, the natural order)"}},"type":"object","required":["id","name_en","name_fr","symbol","line","column","planets","environment_card","displacement_card"],"title":"CardInTableau","description":"A card where it stands in a tableau, with its two related cards there."},"CardInTableauOut":{"properties":{"id":{"type":"string","title":"Id","description":"stable id, e.g. KS"},"name_en":{"type":"string","title":"Name En"},"name_fr":{"type":"string","title":"Name Fr"},"symbol":{"type":"string","title":"Symbol","description":"e.g. K ♠"},"line":{"type":"integer","title":"Line","description":"0 = crown line (3 cards), 1-7 = Mercury to Neptune"},"column":{"type":"integer","title":"Column"},"planets":{"items":{"type":"string"},"type":"array","title":"Planets","description":"[column planet, line planet], or [Crown n, Sun] on the crown line"},"environment_card":{"$ref":"#/components/schemas/Card","description":"the card of this tableau at the place this card holds in the life spread"},"displacement_card":{"$ref":"#/components/schemas/Card","description":"the card of the life spread at the place this card holds in this tableau (the first karma card in tableau 89, the natural order)"},"tableau":{"type":"integer","title":"Tableau"}},"type":"object","required":["id","name_en","name_fr","symbol","line","column","planets","environment_card","displacement_card","tableau"],"title":"CardInTableauOut"},"CommonCard":{"properties":{"card":{"$ref":"#/components/schemas/Card"},"roles_a":{"items":{"type":"string"},"type":"array","title":"Roles A"},"roles_b":{"items":{"type":"string"},"type":"array","title":"Roles B"},"ambiguous":{"type":"boolean","title":"Ambiguous","description":"a role comes from an ambiguous ruler candidate"}},"type":"object","required":["card","roles_a","roles_b","ambiguous"],"title":"CommonCard"},"CurrentSpreadOut":{"properties":{"date_used":{"type":"string","format":"date","title":"Date Used"},"cycle":{"$ref":"#/components/schemas/Cycle"},"spread":{"$ref":"#/components/schemas/Spread"},"birthday_card_position":{"$ref":"#/components/schemas/Position"}},"type":"object","required":["date_used","cycle","spread","birthday_card_position"],"title":"CurrentSpreadOut"},"Cycle":{"type":"string","enum":["life","seven_years","period_52","day"],"title":"Cycle","description":"life: 13-year card; seven_years: card of the year in the 7-year cycle;\nperiod_52: card of the 52-day period; day: card of the day."},"CycleCard":{"properties":{"cycle":{"$ref":"#/components/schemas/Cycle"},"card":{"$ref":"#/components/schemas/CardInTableau","description":"the card of the cycle, with its place, environment and displacement cards in the tableau of the cycle"},"planet":{"type":"string","title":"Planet","description":"planet of the card's place in the 7-card suit (Mercury to Neptune)"},"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"tableau":{"type":"integer","title":"Tableau","description":"index of the quadrature tableau, 0-89 (GET /v1/spreads/{tableau})"},"suit_index":{"type":"integer","title":"Suit Index"},"suit":{"items":{"$ref":"#/components/schemas/CardInTableau"},"type":"array","title":"Suit","description":"the 7 cards following the birthday card in this tableau, each with its place, environment and displacement cards there"},"percent":{"type":"number","title":"Percent","description":"influence, rising from 0 to 1 at mid-card then falling"},"birthday_environment_card":{"$ref":"#/components/schemas/Card","description":"environment card of the BIRTHDAY card in this tableau"},"birthday_displacement_card":{"$ref":"#/components/schemas/Card","description":"displacement card of the BIRTHDAY card in this tableau"}},"type":"object","required":["cycle","card","planet","start","end","tableau","suit_index","suit","percent","birthday_environment_card","birthday_displacement_card"],"title":"CycleCard"},"CyclesOut":{"properties":{"date_used":{"type":"string","format":"date","title":"Date Used"},"cards":{"items":{"$ref":"#/components/schemas/CycleCard"},"type":"array","title":"Cards"}},"type":"object","required":["date_used","cards"],"title":"CyclesOut"},"CyclesRequest":{"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years; default: today in the profile timezone (UTC without one)"},"cycles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Cycle"},"type":"array"},{"type":"null"}],"title":"Cycles","description":"default: all four cycles"}},"additionalProperties":false,"type":"object","required":["profile"],"title":"CyclesRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Position":{"properties":{"line":{"type":"integer","title":"Line","description":"0 = crown line (3 cards), 1-7 = Mercury to Neptune"},"column":{"type":"integer","title":"Column"},"planets":{"items":{"type":"string"},"type":"array","title":"Planets","description":"[column planet, line planet], or [Crown n, Sun] on the crown line"}},"type":"object","required":["line","column","planets"],"title":"Position"},"Profile":{"properties":{"birthdate":{"type":"string","format":"date","title":"Birthdate","description":"YYYY-MM-DD, from 1900-01-01 to today; December 31 is not supported yet"},"birthtime":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}],"title":"Birthtime","description":"HH:MM, 24 h, local time"},"tz":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tz","description":"IANA timezone name, e.g. Europe/Paris (no raw offsets)"}},"additionalProperties":false,"type":"object","required":["birthdate"],"title":"Profile","description":"A person, by birth date. Birth time and timezone only change the sun sign, the decan and\nthe ruling cards; when one is missing the rulers are checked over every possible birth instant."},"ProfileOut":{"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"birthday_card":{"$ref":"#/components/schemas/Card"},"birthday_card_position":{"$ref":"#/components/schemas/Position","description":"position in the life spread"},"karma_cards":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Karma Cards"},"moon_card":{"$ref":"#/components/schemas/Card"},"rulers":{"$ref":"#/components/schemas/Rulers"},"spiritual_suit":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Spiritual Suit"},"life_suit":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Life Suit"},"roles":{"items":{"$ref":"#/components/schemas/Role"},"type":"array","title":"Roles"}},"type":"object","required":["profile","birthday_card","birthday_card_position","karma_cards","moon_card","rulers","spiritual_suit","life_suit","roles"],"title":"ProfileOut"},"ProfileRequest":{"properties":{"profile":{"$ref":"#/components/schemas/Profile"}},"additionalProperties":false,"type":"object","required":["profile"],"title":"ProfileRequest"},"RelationOut":{"properties":{"date_used":{"type":"string","format":"date","title":"Date Used"},"common":{"items":{"$ref":"#/components/schemas/CommonCard"},"type":"array","title":"Common"},"positions":{"additionalProperties":{"additionalProperties":{"$ref":"#/components/schemas/TableauPosition"},"propertyNames":{"$ref":"#/components/schemas/Cycle"},"type":"object"},"type":"object","title":"Positions","description":"{a|b: {cycle: position of the birthday card in the current tableau of the cycle}}"}},"type":"object","required":["date_used","common","positions"],"title":"RelationOut"},"RelationRequest":{"properties":{"a":{"$ref":"#/components/schemas/Profile"},"b":{"$ref":"#/components/schemas/Profile"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years for both profiles; default: today in a's timezone"},"cycles":{"anyOf":[{"items":{"$ref":"#/components/schemas/Cycle"},"type":"array"},{"type":"null"}],"title":"Cycles","description":"default: all four cycles"}},"additionalProperties":false,"type":"object","required":["a","b"],"title":"RelationRequest"},"Role":{"properties":{"card":{"$ref":"#/components/schemas/Card"},"roles":{"items":{"type":"string"},"type":"array","title":"Roles"}},"type":"object","required":["card","roles"],"title":"Role"},"Rulers":{"properties":{"ambiguous":{"type":"boolean","title":"Ambiguous","description":"true: the sign or decan changes during the possible birth window; ask for the missing birth time or timezone"},"sign":{"type":"string","title":"Sign"},"sun_degrees":{"type":"number","title":"Sun Degrees"},"decanate":{"type":"integer","title":"Decanate"},"planetary_ruler":{"items":{"type":"string"},"type":"array","title":"Planetary Ruler","description":"one planet, two for Scorpio and Aquarius"},"decanate_ruler":{"type":"string","title":"Decanate Ruler"},"planetary_ruling_cards":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Planetary Ruling Cards"},"decanate_ruling_cards":{"items":{"$ref":"#/components/schemas/Card"},"type":"array","title":"Decanate Ruling Cards"},"candidates":{"items":{"$ref":"#/components/schemas/Candidate"},"type":"array","title":"Candidates","description":"when ambiguous: rulers at the first and last possible instant"}},"type":"object","required":["ambiguous","sign","sun_degrees","decanate","planetary_ruler","decanate_ruler","planetary_ruling_cards","decanate_ruling_cards","candidates"],"title":"Rulers"},"SearchOut":{"properties":{"card":{"$ref":"#/components/schemas/Card"},"cycle":{"$ref":"#/components/schemas/Cycle"},"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"dates":{"items":{"$ref":"#/components/schemas/TimelineEntry"},"type":"array","title":"Dates"}},"type":"object","required":["card","cycle","start","end","dates"],"title":"SearchOut"},"SearchRequest":{"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"card":{"type":"string","title":"Card","description":"card id: value (A, 2-10, J, Q, K) + suit (H, C, D, S), e.g. KS, 10H, AD"},"cycle":{"$ref":"#/components/schemas/Cycle"},"start":{"type":"string","format":"date","title":"Start","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years"},"end":{"type":"string","format":"date","title":"End","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years; at most 120 years after start"}},"additionalProperties":false,"type":"object","required":["profile","card","cycle","start","end"],"title":"SearchRequest"},"Spread":{"properties":{"tableau":{"type":"integer","title":"Tableau","description":"n + 1 quadratures from the natural order; 89 is the natural order"},"lines":{"items":{"items":{"$ref":"#/components/schemas/Card"},"type":"array"},"type":"array","title":"Lines","description":"line 0: 3 crown cards; lines 1-7: Mercury to Neptune, 7 columns"}},"type":"object","required":["tableau","lines"],"title":"Spread"},"SpreadRequest":{"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"cycle":{"$ref":"#/components/schemas/Cycle"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years; default: today in the profile timezone"}},"additionalProperties":false,"type":"object","required":["profile","cycle"],"title":"SpreadRequest"},"TableauPosition":{"properties":{"line":{"type":"integer","title":"Line","description":"0 = crown line (3 cards), 1-7 = Mercury to Neptune"},"column":{"type":"integer","title":"Column"},"planets":{"items":{"type":"string"},"type":"array","title":"Planets","description":"[column planet, line planet], or [Crown n, Sun] on the crown line"},"tableau":{"type":"integer","title":"Tableau"}},"type":"object","required":["line","column","planets","tableau"],"title":"TableauPosition"},"TimelineEntry":{"properties":{"card":{"$ref":"#/components/schemas/Card"},"planet":{"type":"string","title":"Planet"},"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"tableau":{"type":"integer","title":"Tableau"},"suit_index":{"type":"integer","title":"Suit Index"}},"type":"object","required":["card","planet","start","end","tableau","suit_index"],"title":"TimelineEntry"},"TimelineOut":{"properties":{"cycle":{"$ref":"#/components/schemas/Cycle"},"start":{"type":"string","format":"date","title":"Start"},"end":{"type":"string","format":"date","title":"End"},"cards":{"items":{"$ref":"#/components/schemas/TimelineEntry"},"type":"array","title":"Cards"}},"type":"object","required":["cycle","start","end","cards"],"title":"TimelineOut"},"TimelineRequest":{"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"cycle":{"$ref":"#/components/schemas/Cycle"},"start":{"type":"string","format":"date","title":"Start","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years"},"end":{"type":"string","format":"date","title":"End","description":"YYYY-MM-DD, between the birth date and the birth date + 120 years; at most 120 years after start (20 for period_52, 366 days for day)"}},"additionalProperties":false,"type":"object","required":["profile","cycle","start","end"],"title":"TimelineRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}