{"openapi":"3.1.0","info":{"title":"Numerology API","version":"1.0.0","description":"Pythagorean numerology as an API, computed locally and deterministically. The lifepath endpoint takes a birth date and returns the Life Path number — the single most important number in numerology — by reducing the month, day and year and summing them, with the master numbers 11, 22 and 33 preserved, and it also gives the Birthday number. The name endpoint maps the letters of a name to digits (A=1…I=9, repeating) and returns the Expression (Destiny) number from all letters, the Soul Urge (Heart's Desire) from the vowels, and the Personality number from the consonants, with a full per-letter breakdown. The personal endpoint forecasts the Personal Year, Personal Month and Personal Day for any target date from a birth month and day. Every number comes with its classic meaning, the raw total and the full reduction chain so you can show your working. Accents and punctuation are stripped, dates accept YYYY-MM-DD or DD-MM-YYYY. Everything is computed locally and deterministically, so it is instant and private. Ideal for astrology and self-discovery apps, dating and personality products, content and entertainment sites, and novelty widgets. For entertainment and self-reflection. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is numerology; for sun-sign zodiac use a zodiac API and for tarot draws use a tarot API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/numerology-api","description":"oanor gateway"}],"tags":[{"name":"Numerology"},{"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/lifepath":{"get":{"operationId":"get_v1_lifepath","tags":["Numerology"],"summary":"Life Path number from a birth date","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Birth date YYYY-MM-DD (or DD-MM-YYYY)","schema":{"type":"string"},"example":"1879-03-14"},{"name":"year","in":"query","required":false,"description":"Or year","schema":{"type":"string"}},{"name":"month","in":"query","required":false,"description":"Or month","schema":{"type":"string"}},{"name":"day","in":"query","required":false,"description":"Or day","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"1879-03-14","note":"Life Path = reduce(month) + reduce(day) + reduce(year), then reduce — master numbers 11/22/33 preserved.","life_path":{"master":false,"number":6,"meaning":"The Nurturer — responsible, caring, harmonious, protective.","reduction_steps":[15,6]},"components":{"day":{"steps":[14,5],"value":5},"sum":15,"year":{"steps":[1879,25,7],"value":7},"month":{"steps":[3],"value":3}},"birthday_number":{"master":false,"number":5,"meaning":"The Adventurer — freedom-loving, versatile, curious, dynamic."}},"meta":{"timestamp":"2026-06-04T01:59:12.381Z","request_id":"4c12b835-36ca-4fbf-a03a-f26e0cfaa7a1"},"status":"ok","message":"Life Path number from a birth date","success":true}}}},"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/name":{"get":{"operationId":"get_v1_name","tags":["Numerology"],"summary":"Expression, Soul Urge & Personality","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Full name","schema":{"type":"string"},"example":"John Smith"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Pythagorean system. Expression = all letters, Soul Urge = vowels, Personality = consonants. Master numbers 11/22/33 are preserved.","input":"John Smith","breakdown":[{"value":1,"vowel":false,"letter":"J"},{"value":6,"vowel":true,"letter":"O"},{"value":8,"vowel":false,"letter":"H"},{"value":5,"vowel":false,"letter":"N"},{"value":1,"vowel":false,"letter":"S"},{"value":4,"vowel":false,"letter":"M"},{"value":9,"vowel":true,"letter":"I"},{"value":2,"vowel":false,"letter":"T"},{"value":8,"vowel":false,"letter":"H"}],"soul_urge":{"master":false,"number":6,"meaning":"The Nurturer — responsible, caring, harmonious, protective.","raw_total":15,"reduction_steps":[15,6]},"expression":{"master":false,"number":8,"meaning":"The Powerhouse — ambitious, organised, material mastery, authority.","raw_total":44,"reduction_steps":[44,8]},"personality":{"master":true,"number":11,"meaning":"Master 11 — intuitive visionary, illumination, inspiration.","raw_total":29,"reduction_steps":[29,11]},"letters_used":9},"meta":{"timestamp":"2026-06-04T01:59:12.477Z","request_id":"486f2c86-dfb8-41b3-bb88-bc5e7f544d58"},"status":"ok","message":"Expression, Soul Urge and Personality from a name","success":true}}}},"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/personal":{"get":{"operationId":"get_v1_personal","tags":["Numerology"],"summary":"Personal Year / Month / Day","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Birth date (month & day used)","schema":{"type":"string"},"example":"1879-03-14"},{"name":"month","in":"query","required":false,"description":"Or birth month","schema":{"type":"string"}},{"name":"day","in":"query","required":false,"description":"Or birth day","schema":{"type":"string"}},{"name":"target_year","in":"query","required":true,"description":"Forecast year","schema":{"type":"string"},"example":"2026"},{"name":"target_month","in":"query","required":false,"description":"Forecast month","schema":{"type":"string"},"example":"6"},{"name":"target_day","in":"query","required":false,"description":"Forecast day","schema":{"type":"string"},"example":"4"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Personal Year = reduce(birth month) + reduce(birth day) + reduce(target year). Personal Month/Day build on it.","target_year":2026,"personal_day":{"day":4,"master":false,"number":1,"meaning":"The Leader — independent, pioneering, driven, self-reliant."},"personal_year":{"master":false,"number":9,"meaning":"The Humanitarian — compassionate, idealistic, generous, artistic.","reduction_steps":[9]},"personal_month":{"month":6,"master":false,"number":6,"meaning":"The Nurturer — responsible, caring, harmonious, protective."},"birth_month_day":"03-14"},"meta":{"timestamp":"2026-06-04T01:59:12.571Z","request_id":"b5767f1f-5238-4d6a-ab5f-831aea77b664"},"status":"ok","message":"Personal Year / Month / Day forecast","success":true}}}},"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":"Spec & meanings","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"numerology","note":"All numerology is computed locally and deterministically — no key, no third-party service. For entertainment and self-reflection.","system":"Pythagorean","meanings":{"1":"The Leader — independent, pioneering, driven, self-reliant.","2":"The Peacemaker — cooperative, diplomatic, sensitive, supportive.","3":"The Communicator — expressive, creative, social, optimistic.","4":"The Builder — practical, disciplined, hard-working, grounded.","5":"The Adventurer — freedom-loving, versatile, curious, dynamic.","6":"The Nurturer — responsible, caring, harmonious, protective.","7":"The Seeker — analytical, introspective, spiritual, studious.","8":"The Powerhouse — ambitious, organised, material mastery, authority.","9":"The Humanitarian — compassionate, idealistic, generous, artistic.","11":"Master 11 — intuitive visionary, illumination, inspiration.","22":"Master 22 — the master builder, big dreams made real.","33":"Master 33 — the master teacher, selfless compassion."},"endpoints":["/v1/lifepath","/v1/name","/v1/personal","/v1/meta"],"letter_values":{"a":1,"b":2,"c":3,"d":4,"e":5,"f":6,"g":7,"h":8,"i":9,"j":1,"k":2,"l":3,"m":4,"n":5,"o":6,"p":7,"q":8,"r":9,"s":1,"t":2,"u":3,"v":4,"w":5,"x":6,"y":7,"z":8},"master_numbers":[11,22,33]},"meta":{"timestamp":"2026-06-04T01:59:12.662Z","request_id":"bb19ac20-59d9-4610-bab1-5b8d06d5dea4"},"status":"ok","message":"Meta","success":true}}}},"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":12735,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1425,"monthly_call_quota":22350,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3415,"monthly_call_quota":273500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7215,"monthly_call_quota":1410000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/numerology-api"}