{"openapi":"3.1.0","info":{"title":"Bio API","version":"1.1.0","description":"Biorhythms, chakras, crystals, guided practices and a Law of One library as JSON for AI agents and apps. Pay per call with x402 (USDC), no account or API key. Texts in Italian. Biorhythms are a traditional mathematical model with no proven scientific basis. Use them as prompts for reflection, never as medical, financial or safety advice."},"servers":[{"url":"https://api.cisco-lab.com/bio"}],"paths":{"/catalog":{"get":{"summary":"The whole catalog in one place: every service with its price, and every item you can buy (concepts of all 7 collections, journeys, archetypes, chakras, stones). Filter with type, collection, q (free).","x-price-usd":"free","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["service","concept","journey","archetype","chakra","stone"]}},{"name":"collection","in":"query","required":false,"schema":{"type":"string","description":"Collection id"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Words to match in titles and summaries"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v1/report":{"get":{"summary":"Complete personal report in one call: today's reading with phrases and tips, chakra of the day with practice, best days of the next 30 days for 8 activities, critical days, personal archetype, optional couple compatibility.","x-price-usd":"$0.05","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Day (default: today UTC)"}},{"name":"partner","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional partner birth date for compatibility"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/export":{"get":{"summary":"Full BioAura dataset (JSON): 7 chakras with all practices, 52 stones, 98 check-up statements and scoring keys. For apps and agents (licence included).","x-price-usd":"$1.00","x-payment-protocol":"x402","parameters":[],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/{col}/export":{"get":{"summary":"Full dataset of one Law of One collection (JSON): all concepts with deep dives, subtopics, links, glossary and journeys (licence included).","x-price-usd":"$1.50","x-payment-protocol":"x402","parameters":[{"name":"col","in":"path","required":true,"schema":{"type":"string","enum":["the-answer","lumen","adeptus","arcana","octava","somnia","viridis"],"description":"Collection id"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/export":{"get":{"summary":"The whole Law of One library in one JSON: all 7 collections, 356 concepts, 738 glossary terms, 130 journeys (licence included).","x-price-usd":"$5.00","x-payment-protocol":"x402","parameters":[],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/today":{"get":{"summary":"Biorhythm values for one day: physical, emotional, intellectual and adept cycles (-100..+100), trend and critical days.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Day to read (default: today UTC)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/reading":{"get":{"summary":"Full daily reading ready to show a user: values plus the BioRitmo app phrase and practical tip for each cycle (Italian), with linked chakras.","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Day to read (default: today UTC)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/range":{"get":{"summary":"Biorhythm series for up to 366 days with all critical days.","x-price-usd":"$0.02","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day (default: today UTC)"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":366,"description":"Number of days (default 30)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/best-days":{"get":{"summary":"Best days in the next 1-90 days for an activity (sport, study, exam, social, creative, decisions, meditation, rest), skipping critical days. Ideal for calendar and planning agents.","x-price-usd":"$0.02","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"activity","in":"query","required":true,"schema":{"type":"string","enum":["sport","study","exam","social","creative","decisions","meditation","rest"]}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day (default: today UTC)"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"description":"Window length (default 30)"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"How many days to return (default 5)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/critical":{"get":{"summary":"Upcoming critical (phase change) days of each cycle, for reminders.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day (default: today UTC)"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":366,"description":"Window length (default 60)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/compatibility":{"get":{"summary":"Traditional biorhythm compatibility of two people (0-100% per cycle and overall).","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[{"name":"a","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date of person A"}},{"name":"b","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date of person B"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/daily-focus":{"get":{"summary":"Today's biorhythms mapped to the chakra to work on, with why, affirmation, stone and a short breathing practice. Exclusive BioRitmo x BioAura combination.","x-price-usd":"$0.02","x-payment-protocol":"x402","parameters":[{"name":"birth","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth date YYYY-MM-DD"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Day (default: today UTC)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/chakras":{"get":{"summary":"List of the 7 chakras with a short summary (free).","x-price-usd":"free","parameters":[],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v1/chakras/{id}":{"get":{"summary":"Complete chakra sheet: location, element, body, signals of deficiency and excess, goals, stones, yoga, mudra, mantra, exercise.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","description":"Chakra id (muladhara, svadhisthana, manipura, anahata, vishuddha, ajna, sahasrara) or alias (root, heart, crown...)"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/stones":{"get":{"summary":"List of crystals and stones with themes and linked chakras (free).","x-price-usd":"free","parameters":[],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v1/stones/{id}":{"get":{"summary":"Crystal sheet: description, origin, themes, uses, care, affirmation and linked chakras.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","description":"Stone id from /v1/stones"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/stones/{id}/image":{"get":{"summary":"Original illustration of the stone (WebP image).","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","description":"Stone id from /v1/stones"}}],"responses":{"200":{"description":"image/webp"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/checkup/questions":{"get":{"summary":"Chakra check-up questions (quick 14 or full 28), different every time (free).","x-price-usd":"free","parameters":[{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["quick","full"]}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v1/checkup":{"post":{"summary":"Scores check-up answers: balance of the 7 chakras (deficiency/excess), priorities, goals and where to start.","x-price-usd":"$0.02","x-payment-protocol":"x402","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"answers":{"type":"object","description":"Map question id -> answer 0..3 (from /v1/checkup/questions)","additionalProperties":{"type":"integer","minimum":0,"maximum":3}}},"required":["answers"]},"example":{"answers":{"0":2,"1":0,"2":1,"3":0,"4":3,"5":1,"6":0,"7":1,"8":2,"9":0,"10":1,"11":1,"12":0,"13":2}}}}},"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/practice":{"get":{"summary":"A guided practice for a chakra: meditation, breath, yoga, mudra, mantra, exercise, crystal, food; adapted to deficiency or excess.","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[{"name":"chakra","in":"query","required":true,"schema":{"type":"string","description":"Chakra id or alias"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["meditation","breath","yoga","mudra","mantra","exercise","crystal","food"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["balanced","deficiency","excess","unstable"]}},{"name":"minutes","in":"query","required":false,"schema":{"type":"integer","enum":[3,5,10,15,20]}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/mediate":{"post":{"summary":"Message mediator: rewrites a tense message between two people (e.g. separated parents) in a calm, neutral tone keeping the facts, with a title and the commitment to put in the calendar. AI model cost included in the price; nothing stored.","x-price-usd":"$0.02","x-payment-protocol":"x402","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"The message to rewrite (max 1500 characters)"},"from":{"type":"string"},"to":{"type":"string"},"children":{"type":"array","items":{"type":"string"}},"today":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"lang":{"type":"string","enum":["same","it","en"]}},"required":["text"]},"example":{"text":"Ti ho detto mille volte che sabato Giulia ha danza alle 17, vedi di non dimenticartelo anche stavolta","from":"Anna","to":"Dario","children":["Giulia"],"today":"2026-11-17"}}}},"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/tension":{"post":{"summary":"Tension check before sending: how conflictual a message is (0-100), why, and how to make it calmer. AI model cost included; nothing stored.","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"The message to check (max 1500 characters)"},"lang":{"type":"string","enum":["same","it","en"]}},"required":["text"]},"example":{"text":"Come al solito arrivi in ritardo, sei sempre il solito."}}}},"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/custody":{"post":{"summary":"Custody calendar: from the rule (alternating weeks or fixed weekdays, handover time, one-off swaps) who has the children each day, the handovers and an .ics file for any calendar (format=ics).","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parent_a":{"type":"string"},"parent_b":{"type":"string"},"mode":{"type":"string","enum":["alternate","fixed"]},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"first_parent":{"type":"string","enum":["a","b"]},"weekdays":{"type":"object","description":"Fixed mode: {mon..sun: \"a\"|\"b\"}"},"handover_time":{"type":"string"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"days":{"type":"integer","minimum":1,"maximum":366},"overrides":{"type":"array","items":{"type":"object"}},"format":{"type":"string","enum":["json","ics"]}},"required":["from"]},"example":{"parent_a":"Anna","parent_b":"Dario","mode":"alternate","start":"2026-11-16","first_parent":"a","handover_time":"18:00","from":"2026-11-17","days":30,"overrides":[{"date":"2026-11-25","parent":"b"}]}}}},"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v1/expenses":{"post":{"summary":"Shared expenses: splits each expense by the agreed percentages (50/50, 60/40, 70/30…), totals by category and who owes whom.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parent_a":{"type":"string"},"parent_b":{"type":"string"},"currency":{"type":"string"},"default_share_a":{"type":"number"},"expenses":{"type":"array","items":{"type":"object"}}},"required":["expenses"]},"example":{"parent_a":"Anna","parent_b":"Dario","currency":"EUR","expenses":[{"description":"Dentista","amount":120,"paid_by":"a","share_a":50,"category":"Salute"},{"description":"Libri","amount":80,"paid_by":"b","share_a":60,"category":"Scuola"}]}}}},"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/collections":{"get":{"summary":"The 7 Law of One collections (The Answer encyclopedia and its themed apps) with counts (free).","x-price-usd":"free","parameters":[],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v2/{col}/concepts":{"get":{"summary":"Areas and concept titles of a collection (free).","x-price-usd":"free","parameters":[{"name":"col","in":"path","required":true,"schema":{"type":"string","enum":["the-answer","lumen","adeptus","arcana","octava","somnia","viridis"],"description":"Collection id"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v2/{col}/concepts/{id}":{"get":{"summary":"Full concept entry: summary, deep dive in parts, subtopics, included concepts and explained links to related concepts.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"col","in":"path","required":true,"schema":{"type":"string","enum":["the-answer","lumen","adeptus","arcana","octava","somnia","viridis"],"description":"Collection id"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","description":"Concept id from /v2/{col}/concepts"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/search":{"get":{"summary":"Search all Law of One collections (accent-insensitive, word stems); ranked results with snippets.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Words to search (Italian)"}},{"name":"collection","in":"query","required":false,"schema":{"type":"string","description":"Optional, comma-separated: the-answer, lumen, adeptus, arcana, octava, somnia, viridis"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/glossary":{"get":{"summary":"Glossary lookup across collections: definition and the concept that explains it.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"term","in":"query","required":true,"schema":{"type":"string"}},{"name":"collection","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/{col}/journeys":{"get":{"summary":"Guided reading journeys of a collection, each answering one question (free).","x-price-usd":"free","parameters":[{"name":"col","in":"path","required":true,"schema":{"type":"string","enum":["the-answer","lumen","adeptus","arcana","octava","somnia","viridis"],"description":"Collection id"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"404":{"description":"Not found"}}}},"/v2/{col}/journeys/{id}":{"get":{"summary":"A guided journey step by step, with the summary of each stop.","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[{"name":"col","in":"path","required":true,"schema":{"type":"string","enum":["the-answer","lumen","adeptus","arcana","octava","somnia","viridis"],"description":"Collection id"}},{"name":"id","in":"path","required":true,"schema":{"type":"integer","description":"Journey number from /v2/{col}/journeys"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/archetypes/today":{"get":{"summary":"Archetype of the day from the 22 archetypes of the Law of One (Arcana), the same for everyone on a date or personal with a birth date.","x-price-usd":"$0.005","x-payment-protocol":"x402","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Day (default: today UTC)"}},{"name":"birth","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional birth date for a personal archetype"}}],"responses":{"200":{"description":"OK (JSON)"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}},"/v2/archetypes/{n}/image":{"get":{"summary":"Original card illustration of an archetype (WebP image, drawn by us).","x-price-usd":"$0.01","x-payment-protocol":"x402","parameters":[{"name":"n","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":22}}],"responses":{"200":{"description":"image/webp"},"400":{"description":"Invalid input (no payment requested)"},"402":{"description":"Payment required (x402)"},"404":{"description":"Not found"}}}}}}