{"info":{"name":"API for Astrology: Numerology API","description":"The Numerology API works out Indian and Western numerology over HTTPS. It returns the mulank (birth day number), the bhagyank (destiny number), the name number and the Lo Shu grid. It also returns life path and the other Western numbers, checks for names and numbers, compatibility, good dates and a printable report. You send a name and a birth date as JSON and get JSON back.\n\n**Base URL:** `https://apiforastrology.com/api/numerology`. Every path in this reference starts with `/v1`. It is the same key and the same plan as the Astrology API.\n\n**Authentication:** send your API key in the `Authorization: Bearer <key>` header or the `X-API-Key: <key>` header. Create and revoke keys on the [API keys page](https://apiforastrology.com/account/keys) of your account. Keep the key on your server; do not put it in a web page or app.\n\n**Credits:** every numerology answer is a written reading, so it uses reading credits on live keys, never calls ([pricing](https://apiforastrology.com/pricing)). The language and the length do not change the price. Test keys are never billed and have their own free allowance: 10 calls a minute per key and 1,000 calls a month for all of them. They answer only for the sample people (John Doe, born Aug 15, 1990, and Jane Doe, born Mar 22, 1992), for today or the dates in the docs examples.\n\n**Errors:** every error is JSON in the same shape: `{\"error\": {\"code\": \"...\", \"message\": \"...\", \"field\": \"...\"}}`. `field` is there when one input caused the error.\n\n**Names and dates:** write names in English letters (A to Z); the spelling changes the number, so the API never guesses one. The birth date is the calendar date as it is. Names are read in the Chaldean system, with the Pythagorean numbers beside them. Add `lang` for readings in another language (for example `lang=hi`; `GET /v1/meta` lists every language) and `detail=expanded` for longer ones.\n\n**Reading credits:** each route's price is on its description. Credits are the same in every language, and for standard or longer text. Errors and `GET /v1/health` are free. See [what credits buy](https://apiforastrology.com/pricing#reading-credits).\n\nSet the apiKey variable to your API key before sending a request. Also for Insomnia, Bruno and Hoppscotch: import this file as a Postman v2.1 collection.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://apiforastrology.com/api/numerology","type":"string"},{"key":"apiKey","value":"","type":"string"}],"item":[{"name":"Meta","description":"Service health. No key needed.","item":[{"name":"Health check","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/health","host":["{{baseUrl}}"],"path":["v1","health"],"query":[],"variable":[]},"description":"Returns `{\"status\": \"ok\"}` while the service is running. The only route that needs no API key."},"response":[{"name":"Example answer","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/health","host":["{{baseUrl}}"],"path":["v1","health"],"query":[],"variable":[]},"description":"Returns `{\"status\": \"ok\"}` while the service is running. The only route that needs no API key."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"status\": \"ok\"\n}"}]}]},{"name":"Core numbers","description":"The core numbers for one person: the mulank (birth day number), the bhagyank (destiny number) and the name number, with the Lo Shu grid, lucky day, colors and dates, gemstone and mantra. Also one number on its own, and the whole reading as a printable report.","item":[{"name":"Core numbers and Lo Shu grid","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/profile","host":["{{baseUrl}}"],"path":["v1","profile"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"The core numbers for one person, each with a short reading. The **mulank** (birth day number) comes from the day of birth. The **bhagyank** (destiny number) comes from the full date. The **name number** is given in Chaldean (read) and Pythagorean (numbers only, `read: false`). The lucky day, colors and friendly numbers come from the mulank's planet. The **Lo Shu grid** comes with its missing and repeated numbers and its full or empty lines. `loshu.basis` says which digits were placed. `not_included` names what is not computed yet.\n\n**Uses 3 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/profile","host":["{{baseUrl}}"],"path":["v1","profile"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"The core numbers for one person, each with a short reading. The **mulank** (birth day number) comes from the day of birth. The **bhagyank** (destiny number) comes from the full date. The **name number** is given in Chaldean (read) and Pythagorean (numbers only, `read: false`). The lucky day, colors and friendly numbers come from the mulank's planet. The **Lo Shu grid** comes with its missing and repeated numbers and its full or empty lines. `loshu.basis` says which digits were placed. `not_included` names what is not computed yet.\n\n**Uses 3 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"input\": {\n    \"name\": \"John Doe\",\n    \"birth_date\": \"1990-08-15\"\n  },\n  \"mulank\": {\n    \"number\": 6,\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"about\": \"Your mulank (birth day number) comes from the day you were born. It shows how you act day to day and how people first see you.\",\n    \"reading\": \"You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort.\",\n    \"topics\": [\n      {\n        \"facet\": \"nature\",\n        \"title\": \"Nature\",\n        \"text\": \"Mulank 6 is ruled by Venus. You care about home, family and things that look good. People feel welcome around you, and you often keep peace in a group. You…\"\n      },\n      {\n        \"facet\": \"career\",\n        \"title\": \"Career\",\n        \"text\": \"You tend to work best in a pleasant place where you can make things better for people. You often have taste and a gift for making people feel at ease. Harsh or…\"\n      }\n    ]\n  },\n  \"bhagyank\": {\n    \"number\": 6,\n    \"total\": 33,\n    \"master\": true,\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"about\": \"Your bhagyank (destiny number) comes from your full birth date. It shows the direction your life tends to take as you grow older.\",\n    \"reading\": \"Your life tends to center on family, love and responsibility. Work linked to beauty, art, care or comfort often suits this path.\",\n    \"topics\": [\n      {\n        \"facet\": \"nature\",\n        \"title\": \"Nature\",\n        \"text\": \"With Venus behind your bhagyank, care for family and a love of beauty tend to grow with age. You often become the one who brings people together and makes a…\"\n      },\n      {\n        \"facet\": \"career\",\n        \"title\": \"Career\",\n        \"text\": \"Your path tends to grow around beauty, care and comfort. You often do well in work that makes people's lives nicer or easier. Fields that tend to suit you…\"\n      }\n    ]\n  },\n  \"name_number\": {\n    \"default_system\": \"chaldean\",\n    \"chaldean\": {\n      \"system\": \"chaldean\",\n      \"name\": \"John Doe\",\n      \"total\": 34,\n      \"compound\": 34,\n      \"number\": 7,\n      \"master\": false,\n      \"words\": [\n        {\n          \"word\": \"John\",\n          \"total\": 18,\n          \"number\": 9\n        },\n        {\n          \"word\": \"Doe\",\n          \"total\": 16,\n          \"number\": 7\n        }\n      ],\n      \"system_name\": \"Chaldean\",\n      \"planet\": \"Ketu\",\n      \"planet_name\": \"Ketu\",\n      \"about\": \"Your name number comes from the letters of your name. It shows how your name shapes the way people take you.\",\n      \"reading\": \"Your name gives a quiet, thoughtful feel. People may see you as private or deep.\"\n    },\n    \"pythagorean\": {\n      \"system\": \"pythagorean\",\n      \"name\": \"John Doe\",\n      \"total\": 35,\n      \"compound\": 35,\n      \"number\": 8,\n      \"master\": false,\n      \"words\": [\n        {\n          \"word\": \"John\",\n          \"total\": 20,\n          \"number\": 2\n        },\n        {\n          \"word\": \"Doe\",\n          \"total\": 15,\n          \"number\": 6\n        }\n      ],\n      \"system_name\": \"Pythagorean\",\n      \"read\": false\n    }\n  },\n  \"lucky\": {\n    \"from\": \"mulank\",\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"day\": \"Friday\",\n    \"day_name\": \"Friday\",\n    \"day_via\": null,\n    \"colors\": [\n      {\n        \"color\": \"white\",\n        \"name\": \"white\"\n      },\n      {\n        \"color\": \"pastel pink\",\n        \"name\": \"pastel pink\"\n      }\n    ],\n    \"numbers\": {\n      \"friendly\": [\n        4,\n        5\n      ],\n      \"neutral\": [\n        3,\n        7\n      ],\n      \"unfriendly\": [\n        1,\n        2\n      ]\n    },\n    \"dates\": [\n      4,\n      5\n    ],\n    \"dates_about\": \"Dates of the month that add up to a number friendly to your mulank. They tend to suit starting things.\"\n  },\n  \"remedies\": {\n    \"from\": \"mulank\",\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"direction\": \"south-east\",\n    \"direction_name\": \"South-east\",\n    \"direction_about\": \"The direction linked to your ruling planet. Facing it for work or study is a common practice.\",\n    \"deity\": \"Lakshmi\",\n    \"deity_name\": \"Lakshmi\",\n    \"deity_about\": \"The deity often worshipped for your ruling planet. Families and regions may follow other customs.\",\n    \"fast_day\": \"Friday\",\n    \"fast_day_name\": \"Friday\",\n    \"fast_about\": \"The weekday of your ruling planet. People who fast for this planet usually keep this day.\",\n    \"gemstone\": {\n      \"stone\": \"diamond\",\n      \"metal\": \"silver or platinum\",\n      \"finger\": \"middle\",\n      \"caution\": null,\n      \"stone_name\": \"Diamond (heera)\",\n      \"metal_name\": \"silver or platinum\",\n      \"finger_name\": \"middle finger\",\n      \"about\": \"The stone linked to your ruling planet. Numbers alone cannot say whether you should wear it, so check your birth chart with an astrologer first.\"\n    },\n    \"mantra\": {\n      \"key\": \"venus:beeja\",\n      \"text\": \"ॐ द्रां द्रीं द्रौं सः शुक्राय नमः\",\n      \"latin\": \"Om Draam Dreem Draum Sah Shukraya Namah\",\n      \"audio\": \"shukra-beej-mantra.mp3\",\n      \"daily\": 108,\n      \"japa\": 16000,\n      \"japa_sources\": [],\n      \"about\": \"The beej mantra (short seed mantra) of your ruling planet. One round is 108 times. The full count is for a complete practice.\",\n      \"japa_note\": null\n    }\n  },\n  \"loshu\": {\n    \"cells\": [\n      [\n        {\n          \"number\": 4,\n          \"count\": 0\n        },\n        {\n          \"number\": 9,\n          \"count\": 2\n        }\n      ],\n      [\n        {\n          \"number\": 3,\n          \"count\": 0\n        },\n        {\n          \"number\": 5,\n          \"count\": 1\n        }\n      ]\n    ],\n    \"placed\": [\n      {\n        \"number\": 1,\n        \"from\": \"date\",\n        \"from_name\": \"birth date\"\n      },\n      {\n        \"number\": 5,\n        \"from\": \"date\",\n        \"from_name\": \"birth date\"\n      }\n    ],\n    \"missing\": [\n      {\n        \"number\": 2,\n        \"reading\": \"2 is missing. You may not always notice how others feel. Slowing down to listen helps.\"\n      },\n      {\n        \"number\": 3,\n        \"reading\": \"3 is missing. Planning ahead may not come easily. Writing your plans down can help.\"\n      }\n    ],\n    \"repeated\": [\n      {\n        \"number\": 1,\n        \"count\": 2,\n        \"reading\": \"1 appears more than once. Your self-belief is strong. Too much of it can come across as pride.\"\n      },\n      {\n        \"number\": 6,\n        \"count\": 2,\n        \"reading\": \"6 appears more than once. You care a lot for home and family. Do not carry everyone's load alone.\"\n      }\n    ],\n    \"planes\": [\n      {\n        \"id\": \"practical\",\n        \"numbers\": [\n          8,\n          1\n        ],\n        \"state\": \"full\",\n        \"name\": \"Practical line\",\n        \"reading\": \"The practical line is full. You tend to be good with hands-on work and money matters.\"\n      },\n      {\n        \"id\": \"will\",\n        \"numbers\": [\n          9,\n          5\n        ],\n        \"state\": \"full\",\n        \"name\": \"Willpower line\",\n        \"reading\": \"The willpower line is full. Once you decide, you tend to see it through.\"\n      }\n    ],\n    \"basis\": \"Non-zero digits of the birth date (DD MM YYYY), plus the bhagyank, plus the mulank when the day has two digits. Zero has no cell.\",\n    \"about\": \"The Lo Shu grid is a 3 by 3 square of the numbers 1 to 9. The digits of your birth date are placed in it. Numbers that are missing or repeated show what comes…\",\n    \"summary\": {\n      \"strong\": [\n        {\n          \"from\": \"number\",\n          \"number\": 1,\n          \"area\": \"self-belief\"\n        },\n        {\n          \"from\": \"number\",\n          \"number\": 6,\n          \"area\": \"caring for family\"\n        }\n      ],\n      \"effort\": [\n        {\n          \"from\": \"number\",\n          \"number\": 2,\n          \"area\": \"noticing how others feel\"\n        },\n        {\n          \"from\": \"number\",\n          \"number\": 3,\n          \"area\": \"planning ahead\"\n        }\n      ],\n      \"text\": \"Comes easily to you: self-belief, caring for family, drive, hands-on work and money and seeing things through. Needs more effort: noticing how others feel,…\"\n    },\n    \"number_tip\": {\n      \"digits\": [\n        2,\n        3\n      ],\n      \"text\": \"Many people choose a mobile or vehicle number that has their missing numbers (2, 3, 4 and 7). This is a popular belief, not a promise.\"\n    },\n    \"birth_only\": \"Your grid comes only from your birth date. Changing your name does not change it.\"\n  },\n  \"not_included\": {\n    \"compound_meanings\": \"The compound number (10 to 52) is returned, but not read: its meanings wait for the astrologer.\",\n    \"western_numbers\": \"Life path, expression, soul urge, pinnacles, life cycles and the personal year come from the western route.\"\n  },\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"Numerology report (HTML or JSON)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/report?format=json&as_of=2026-10-01&detail=standard","host":["{{baseUrl}}"],"path":["v1","report"],"query":[{"key":"format","value":"json","description":"`html` (default) or `json`.","disabled":false},{"key":"as_of","value":"2026-10-01","description":"The date to read the personal year, month and day (and the current pinnacle and life cycle) for, `YYYY-MM-DD`. Defaults to today. Echoed back in `as_of`.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings. A report is read in full, so the default is `expanded`; send `standard` for a short version.","disabled":false}],"variable":[]},"description":"The whole reading as one printable book. It holds the numbers at a glance, the mulank, bhagyank and name number, and the Lo Shu grid (drawn). It also holds the lucky day and colors, the Western numbers, karmic lessons, challenges and life stages. It also holds the personal year, month and day, and any numbers sent in `numbers`. Every number and paragraph is what the other numerology routes return.\n\n`format=html` (default) returns one self-contained page that fetches nothing and prints to A4. `format=json` returns the same book as data: `chapters[].items[]`. Each item is a `section` (blocks of `title`, `paragraphs`, `note`), a `table` (`columns`, `rows`) or `loshu`. A `loshu` item has `cells` and an `svg` that carries its look as attributes, so it draws anywhere.\n\n**Uses 25 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/report?format=json&as_of=2026-10-01&detail=standard","host":["{{baseUrl}}"],"path":["v1","report"],"query":[{"key":"format","value":"json","description":"`html` (default) or `json`.","disabled":false},{"key":"as_of","value":"2026-10-01","description":"The date to read the personal year, month and day (and the current pinnacle and life cycle) for, `YYYY-MM-DD`. Defaults to today. Echoed back in `as_of`.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings. A report is read in full, so the default is `expanded`; send `standard` for a short version.","disabled":false}],"variable":[]},"description":"The whole reading as one printable book. It holds the numbers at a glance, the mulank, bhagyank and name number, and the Lo Shu grid (drawn). It also holds the lucky day and colors, the Western numbers, karmic lessons, challenges and life stages. It also holds the personal year, month and day, and any numbers sent in `numbers`. Every number and paragraph is what the other numerology routes return.\n\n`format=html` (default) returns one self-contained page that fetches nothing and prints to A4. `format=json` returns the same book as data: `chapters[].items[]`. Each item is a `section` (blocks of `title`, `paragraphs`, `note`), a `table` (`columns`, `rows`) or `loshu`. A `loshu` item has `cells` and an `svg` that carries its look as attributes, so it draws anywhere.\n\n**Uses 25 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"lang\": \"en\",\n  \"prepared\": \"2026-11-07\",\n  \"as_of\": \"2026-10-01\",\n  \"tint\": {\n    \"planet\": \"Venus\",\n    \"paper\": \"#fcf5f8\",\n    \"soft\": \"#f5e3eb\",\n    \"highlight\": \"#f0cfdd\",\n    \"strong\": \"#963a62\",\n    \"mute\": \"#75606a\"\n  },\n  \"cover\": {\n    \"brand\": \"\",\n    \"kicker\": \"Numerology report\",\n    \"title\": \"John Doe\",\n    \"born\": \"Born August 15, 1990\",\n    \"glance\": \"Mulank 6 · Bhagyank 6 · Name number 7\",\n    \"promise\": \"What your birth date and your name say about you, worked out step by step and written in plain words.\",\n    \"wheel_title\": \"Your numbers on the wheel of nine\",\n    \"wheel_caption\": \"The ring holds the numbers 1 to 9, each in the color of its planet. Your three numbers are marked. Your Lo Shu grid sits in the middle.\",\n    \"wheel_svg\": \"<svg xmlns=\\\"http://www.w3.org/2000/svg\\\" viewBox=\\\"0 0 600 670\\\" width=\\\"100%\\\" role=\\\"img\\\" aria-label=\\\"Your numbers on the wheel of nine\\\"><path d=\\\"M207.0,44.4…\"\n  },\n  \"labels\": {\n    \"contents\": \"Contents\",\n    \"chapter\": \"Chapter\",\n    \"closing\": \"A last word\",\n    \"closing_text\": \"Numbers show leanings, not a fixed future. Read this as a guide to know yourself better, and make your own choices.\"\n  },\n  \"chapters\": [\n    {\n      \"key\": \"glance\",\n      \"number\": 1,\n      \"title\": \"Your numbers at a glance\",\n      \"items\": [\n        {\n          \"type\": \"table\",\n          \"title\": null,\n          \"columns\": [\n            \"What\",\n            \"Number\"\n          ],\n          \"rows\": [\n            [\n              \"Mulank (birth day number)\",\n              \"6\"\n            ],\n            [\n              \"Bhagyank (destiny number)\",\n              \"6\"\n            ]\n          ]\n        }\n      ]\n    },\n    {\n      \"key\": \"mulank\",\n      \"number\": 2,\n      \"title\": \"Your mulank\",\n      \"items\": [\n        {\n          \"type\": \"section\",\n          \"blocks\": [\n            {\n              \"title\": \"Mulank (birth day number): 6\",\n              \"paragraphs\": [\n                \"Your mulank (birth day number) comes from the day you were born. It shows how you act day to day and how people first see you.\",\n                \"You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort.\"\n              ]\n            },\n            {\n              \"title\": \"Nature\",\n              \"paragraphs\": [\n                \"Mulank 6 is ruled by Venus. You care about home, family and things that look good. People feel welcome around you, and you often keep peace in a group. You…\"\n              ]\n            }\n          ]\n        }\n      ]\n    }\n  ],\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"not_included\": {\n    \"compound_meanings\": \"The compound number (10 to 52) is returned, but not read: its meanings wait for the astrologer.\",\n    \"western_numbers\": \"Life path, expression, soul urge, pinnacles, life cycles and the personal year come from the western route.\"\n  },\n  \"footer\": \"Prepared on November 7, 2026.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"One number as a mulank","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/guide/:number","host":["{{baseUrl}}"],"path":["v1","guide",":number"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[{"key":"number","value":"6","description":"The number, from 1 to 9."}]},"description":"Everything about one number from 1 to 9 as a mulank, with no birth date. It returns who has it (`born_on`, the days of a month) and its planet. It returns the mulank, bhagyank and name readings and the five topic sections. It also returns the lucky day, colors, numbers and dates, and the gemstone, mantra, direction, deity and fast day. For a page such as \"mulank 5\". The same entries the profile reads.\n\n**Uses 3 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits)."},"response":[{"name":"Example answer","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/guide/:number","host":["{{baseUrl}}"],"path":["v1","guide",":number"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[{"key":"number","value":"6","description":"The number, from 1 to 9."}]},"description":"Everything about one number from 1 to 9 as a mulank, with no birth date. It returns who has it (`born_on`, the days of a month) and its planet. It returns the mulank, bhagyank and name readings and the five topic sections. It also returns the lucky day, colors, numbers and dates, and the gemstone, mantra, direction, deity and fast day. For a page such as \"mulank 5\". The same entries the profile reads.\n\n**Uses 3 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits)."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"number\": 6,\n  \"planet\": \"Venus\",\n  \"planet_name\": \"Venus\",\n  \"born_on\": [\n    6,\n    15\n  ],\n  \"mulank\": {\n    \"number\": 6,\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"about\": \"Your mulank (birth day number) comes from the day you were born. It shows how you act day to day and how people first see you.\",\n    \"reading\": \"You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort.\",\n    \"topics\": [\n      {\n        \"facet\": \"nature\",\n        \"title\": \"Nature\",\n        \"text\": \"Mulank 6 is ruled by Venus. You care about home, family and things that look good. People feel welcome around you, and you often keep peace in a group. You…\"\n      },\n      {\n        \"facet\": \"career\",\n        \"title\": \"Career\",\n        \"text\": \"You tend to work best in a pleasant place where you can make things better for people. You often have taste and a gift for making people feel at ease. Harsh or…\"\n      }\n    ]\n  },\n  \"bhagyank\": {\n    \"number\": 6,\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"about\": \"Your bhagyank (destiny number) comes from your full birth date. It shows the direction your life tends to take as you grow older.\",\n    \"reading\": \"Your life tends to center on family, love and responsibility. Work linked to beauty, art, care or comfort often suits this path.\",\n    \"topics\": [\n      {\n        \"facet\": \"nature\",\n        \"title\": \"Nature\",\n        \"text\": \"With Venus behind your bhagyank, care for family and a love of beauty tend to grow with age. You often become the one who brings people together and makes a…\"\n      },\n      {\n        \"facet\": \"career\",\n        \"title\": \"Career\",\n        \"text\": \"Your path tends to grow around beauty, care and comfort. You often do well in work that makes people's lives nicer or easier. Fields that tend to suit you…\"\n      }\n    ]\n  },\n  \"name\": {\n    \"about\": \"Your name number comes from the letters of your name. It shows how your name shapes the way people take you.\",\n    \"reading\": \"Your name feels warm and pleasant. People may connect it with charm and good taste.\"\n  },\n  \"lucky\": {\n    \"from\": \"mulank\",\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"day\": \"Friday\",\n    \"day_name\": \"Friday\",\n    \"day_via\": null,\n    \"colors\": [\n      {\n        \"color\": \"white\",\n        \"name\": \"white\"\n      },\n      {\n        \"color\": \"pastel pink\",\n        \"name\": \"pastel pink\"\n      }\n    ],\n    \"numbers\": {\n      \"friendly\": [\n        4,\n        5\n      ],\n      \"neutral\": [\n        3,\n        7\n      ],\n      \"unfriendly\": [\n        1,\n        2\n      ]\n    },\n    \"dates\": [\n      4,\n      5\n    ],\n    \"dates_about\": \"Dates of the month that add up to a number friendly to your mulank. They tend to suit starting things.\"\n  },\n  \"remedies\": {\n    \"from\": \"mulank\",\n    \"planet\": \"Venus\",\n    \"planet_name\": \"Venus\",\n    \"direction\": \"south-east\",\n    \"direction_name\": \"South-east\",\n    \"direction_about\": \"The direction linked to your ruling planet. Facing it for work or study is a common practice.\",\n    \"deity\": \"Lakshmi\",\n    \"deity_name\": \"Lakshmi\",\n    \"deity_about\": \"The deity often worshipped for your ruling planet. Families and regions may follow other customs.\",\n    \"fast_day\": \"Friday\",\n    \"fast_day_name\": \"Friday\",\n    \"fast_about\": \"The weekday of your ruling planet. People who fast for this planet usually keep this day.\",\n    \"gemstone\": {\n      \"stone\": \"diamond\",\n      \"metal\": \"silver or platinum\",\n      \"finger\": \"middle\",\n      \"caution\": null,\n      \"stone_name\": \"Diamond (heera)\",\n      \"metal_name\": \"silver or platinum\",\n      \"finger_name\": \"middle finger\",\n      \"about\": \"The stone linked to your ruling planet. Numbers alone cannot say whether you should wear it, so check your birth chart with an astrologer first.\"\n    },\n    \"mantra\": {\n      \"key\": \"venus:beeja\",\n      \"text\": \"ॐ द्रां द्रीं द्रौं सः शुक्राय नमः\",\n      \"latin\": \"Om Draam Dreem Draum Sah Shukraya Namah\",\n      \"audio\": \"shukra-beej-mantra.mp3\",\n      \"daily\": 108,\n      \"japa\": 16000,\n      \"japa_sources\": [],\n      \"about\": \"The beej mantra (short seed mantra) of your ruling planet. One round is 108 times. The full count is for a complete practice.\",\n      \"japa_note\": null\n    }\n  },\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]}]},{"name":"Names","description":"Names: a name and its spellings against a person's numbers, spellings that sound the same and suit them, and baby names whose number suits a child.","item":[{"name":"Name checker","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/name","host":["{{baseUrl}}"],"path":["v1","name"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Reads a name, and up to 10 other spellings of it, against the person's mulank and bhagyank. Each spelling gets its Chaldean and Pythagorean numbers and a `fit`: `good`, `neutral`, `mixed` or `difficult`, with the one-sided relation behind it. The rule: a friend and no enemy is good; an enemy and no friend is difficult; one of each is mixed; neither is neutral. Spellings come back in the order sent and are **never ranked**.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\",\n  \"variants\": [\n    \"Jon Doe\",\n    \"John Dow\"\n  ]\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/name","host":["{{baseUrl}}"],"path":["v1","name"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Reads a name, and up to 10 other spellings of it, against the person's mulank and bhagyank. Each spelling gets its Chaldean and Pythagorean numbers and a `fit`: `good`, `neutral`, `mixed` or `difficult`, with the one-sided relation behind it. The rule: a friend and no enemy is good; an enemy and no friend is difficult; one of each is mixed; neither is neutral. Spellings come back in the order sent and are **never ranked**.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\",\n  \"variants\": [\n    \"Jon Doe\",\n    \"John Dow\"\n  ]\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"person\": {\n    \"birth_date\": \"1990-08-15\",\n    \"mulank\": 6,\n    \"bhagyank\": 6\n  },\n  \"system\": \"chaldean\",\n  \"about\": \"A name is read from its letters.\",\n  \"spellings\": [\n    {\n      \"name\": \"John Doe\",\n      \"chaldean\": {\n        \"total\": 34,\n        \"compound\": 34,\n        \"number\": 7,\n        \"master\": false,\n        \"words\": [\n          {\n            \"word\": \"John\",\n            \"total\": 18,\n            \"number\": 9\n          },\n          {\n            \"word\": \"Doe\",\n            \"total\": 16,\n            \"number\": 7\n          }\n        ]\n      },\n      \"pythagorean\": {\n        \"total\": 35,\n        \"number\": 8,\n        \"master\": false\n      },\n      \"planet\": \"Ketu\",\n      \"planet_name\": \"Ketu\",\n      \"fit\": {\n        \"number\": 7,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 6,\n            \"to_number\": 7,\n            \"relation\": \"neutral\",\n            \"via\": [\n              \"Ketu\"\n            ],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"neutral\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 6,\n            \"to_number\": 7,\n            \"relation\": \"neutral\",\n            \"via\": [\n              \"Ketu\"\n            ],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"neutral\"\n          }\n        ],\n        \"outcome\": \"neutral\",\n        \"outcome_name\": \"Neutral\",\n        \"reading\": \"This number is neutral to your own numbers. It neither helps nor gets in the way much.\"\n      }\n    },\n    {\n      \"name\": \"Jon Doe\",\n      \"chaldean\": {\n        \"total\": 29,\n        \"compound\": 29,\n        \"number\": 2,\n        \"master\": true,\n        \"words\": [\n          {\n            \"word\": \"Jon\",\n            \"total\": 13,\n            \"number\": 4\n          },\n          {\n            \"word\": \"Doe\",\n            \"total\": 16,\n            \"number\": 7\n          }\n        ]\n      },\n      \"pythagorean\": {\n        \"total\": 27,\n        \"number\": 9,\n        \"master\": false\n      },\n      \"planet\": \"Moon\",\n      \"planet_name\": \"Moon\",\n      \"fit\": {\n        \"number\": 2,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 6,\n            \"to_number\": 2,\n            \"relation\": \"enemy\",\n            \"via\": [],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"unfriendly\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 6,\n            \"to_number\": 2,\n            \"relation\": \"enemy\",\n            \"via\": [],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"unfriendly\"\n          }\n        ],\n        \"outcome\": \"difficult\",\n        \"outcome_name\": \"Not a good fit\",\n        \"reading\": \"This number does not get along with your own numbers. It may get in your way more than it helps.\"\n      }\n    }\n  ],\n  \"ranked\": false,\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"Name spelling suggestions","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/name/suggest","host":["{{baseUrl}}"],"path":["v1","name","suggest"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Spellings of one word of the name (`part`, default the first name) that sound the same. Each gives a Chaldean name number in `targets` (default: every number whose `fit` with the person is `good`). Only common spelling habits are tried, at most two at a time. They are `a`/`aa`, `i`/`ee`, `u`/`oo`, `v`/`w` (not as the first letter) and `ph`/`f`, plus a doubled last consonant and a silent `h` after a final `a`. Each suggestion lists its `changes`. Suggestions come in a fixed order (fewer changes first, then A to Z) and are **never ranked**. `found` counts every match before `limit`; `none` is a sentence when there is no match.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/name/suggest","host":["{{baseUrl}}"],"path":["v1","name","suggest"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Spellings of one word of the name (`part`, default the first name) that sound the same. Each gives a Chaldean name number in `targets` (default: every number whose `fit` with the person is `good`). Only common spelling habits are tried, at most two at a time. They are `a`/`aa`, `i`/`ee`, `u`/`oo`, `v`/`w` (not as the first letter) and `ph`/`f`, plus a doubled last consonant and a silent `h` after a final `a`. Each suggestion lists its `changes`. Suggestions come in a fixed order (fewer changes first, then A to Z) and are **never ranked**. `found` counts every match before `limit`; `none` is a sentence when there is no match.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"name\": \"John Doe\",\n  \"part\": 0,\n  \"word\": \"John\",\n  \"current\": {\n    \"total\": 34,\n    \"compound\": 34,\n    \"number\": 7,\n    \"planet\": \"Ketu\",\n    \"planet_name\": \"Ketu\",\n    \"fit\": {\n      \"number\": 7,\n      \"links\": [\n        {\n          \"from\": \"mulank\",\n          \"from_number\": 6,\n          \"to_number\": 7,\n          \"relation\": \"neutral\",\n          \"via\": [\n            \"Ketu\"\n          ],\n          \"from_name\": \"mulank\",\n          \"relation_name\": \"neutral\"\n        },\n        {\n          \"from\": \"bhagyank\",\n          \"from_number\": 6,\n          \"to_number\": 7,\n          \"relation\": \"neutral\",\n          \"via\": [\n            \"Ketu\"\n          ],\n          \"from_name\": \"bhagyank\",\n          \"relation_name\": \"neutral\"\n        }\n      ],\n      \"outcome\": \"neutral\",\n      \"outcome_name\": \"Neutral\",\n      \"reading\": \"This number is neutral to your own numbers. It neither helps nor gets in the way much.\"\n    }\n  },\n  \"targets\": [\n    4,\n    5\n  ],\n  \"tried\": 1,\n  \"found\": 0,\n  \"suggestions\": [],\n  \"person\": {\n    \"birth_date\": \"1990-08-15\",\n    \"mulank\": 6,\n    \"bhagyank\": 6\n  },\n  \"system\": \"chaldean\",\n  \"about\": \"These spellings sound the same as your name but add up to a number that suits you. Only small, common spelling changes are tried.\",\n  \"none\": \"No small spelling change gives a number that suits you. Your current spelling can stay as it is.\",\n  \"ranked\": false,\n  \"not_claimed_spelling\": \"A new spelling changes the number of the name, not the person. Choose one only if you are happy to use it every day.\",\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"Baby name finder","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/baby-names","host":["{{baseUrl}}"],"path":["v1","baby-names"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Names from our own list whose Chaldean number suits the child, read by the same rule as the name checker. With a `surname` the full name is counted. Filter by `gender`, `origin`, first `syllables` in Devanagari or Gujarati letters (for naming by birth star) or English starting `letters`. Results are `groups`, one per number, A to Z inside, **never ranked**; each group gives `found` so `limit` never hides how many exist. `per_syllable` and `syllables_without_names` show which starting sounds have no name yet. Names with a sensitive meaning are never suggested (`list.kept_out`). A modern name with no known meaning is suggested, with `meaning_known: false`. Each name gives `origin` as the list has it (use it to filter) and `origin_name` in the reader's language. The list is not yet reviewed (`list.reviewed`, `review_note`).\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"birth_date\": \"1992-03-22\",\n  \"surname\": \"Doe\",\n  \"gender\": \"boy\",\n  \"letters\": [\n    \"J\"\n  ]\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/baby-names","host":["{{baseUrl}}"],"path":["v1","baby-names"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Names from our own list whose Chaldean number suits the child, read by the same rule as the name checker. With a `surname` the full name is counted. Filter by `gender`, `origin`, first `syllables` in Devanagari or Gujarati letters (for naming by birth star) or English starting `letters`. Results are `groups`, one per number, A to Z inside, **never ranked**; each group gives `found` so `limit` never hides how many exist. `per_syllable` and `syllables_without_names` show which starting sounds have no name yet. Names with a sensitive meaning are never suggested (`list.kept_out`). A modern name with no known meaning is suggested, with `meaning_known: false`. Each name gives `origin` as the list has it (use it to filter) and `origin_name` in the reader's language. The list is not yet reviewed (`list.reviewed`, `review_note`).\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"birth_date\": \"1992-03-22\",\n  \"surname\": \"Doe\",\n  \"gender\": \"boy\",\n  \"letters\": [\n    \"J\"\n  ]\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"person\": {\n    \"birth_date\": \"1992-03-22\",\n    \"mulank\": 4,\n    \"bhagyank\": 1\n  },\n  \"system\": \"chaldean\",\n  \"filters\": {\n    \"surname\": \"Doe\",\n    \"gender\": \"boy\",\n    \"origin\": \"indian\",\n    \"syllables\": null,\n    \"letters\": [\n      \"J\"\n    ]\n  },\n  \"about\": \"These names add up to a number that suits your child. The number is worked out from the date of birth. With a surname, the full name is counted.\",\n  \"targets\": [\n    3,\n    5\n  ],\n  \"searched\": 95,\n  \"found\": 28,\n  \"groups\": [\n    {\n      \"number\": 3,\n      \"planet\": \"Jupiter\",\n      \"planet_name\": \"Jupiter\",\n      \"fit\": {\n        \"number\": 3,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 4,\n            \"to_number\": 3,\n            \"relation\": \"neutral\",\n            \"via\": [\n              \"Rahu\"\n            ],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"neutral\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 1,\n            \"to_number\": 3,\n            \"relation\": \"friend\",\n            \"via\": [],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"friendly\"\n          }\n        ],\n        \"outcome\": \"good\",\n        \"outcome_name\": \"Good fit\",\n        \"reading\": \"This number gets along well with your own numbers. It tends to support you.\"\n      },\n      \"found\": 14,\n      \"names\": [\n        {\n          \"name\": \"Jahaan\",\n          \"full_name\": \"Jahaan Doe\",\n          \"devanagari\": \"जहान\",\n          \"meaning\": \"The world\",\n          \"meaning_known\": true,\n          \"gender\": \"boy\",\n          \"gender_name\": \"Boy\",\n          \"origin\": \"Persian\",\n          \"origin_name\": \"Persian\",\n          \"first_syllable\": \"ज\",\n          \"variants\": [],\n          \"number\": 3,\n          \"first_name_number\": 5,\n          \"needs_check\": false\n        },\n        {\n          \"name\": \"Jaimini\",\n          \"full_name\": \"Jaimini Doe\",\n          \"devanagari\": \"जैमिनी\",\n          \"meaning\": \"A great sage\",\n          \"meaning_known\": true,\n          \"gender\": \"boy\",\n          \"gender_name\": \"Boy\",\n          \"origin\": \"Hindu\",\n          \"origin_name\": \"Hindu\",\n          \"first_syllable\": \"जै\",\n          \"variants\": [],\n          \"number\": 3,\n          \"first_name_number\": 5,\n          \"needs_check\": false\n        }\n      ]\n    },\n    {\n      \"number\": 5,\n      \"planet\": \"Mercury\",\n      \"planet_name\": \"Mercury\",\n      \"fit\": {\n        \"number\": 5,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 4,\n            \"to_number\": 5,\n            \"relation\": \"friend\",\n            \"via\": [\n              \"Rahu\"\n            ],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"friendly\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 1,\n            \"to_number\": 5,\n            \"relation\": \"neutral\",\n            \"via\": [],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"neutral\"\n          }\n        ],\n        \"outcome\": \"good\",\n        \"outcome_name\": \"Good fit\",\n        \"reading\": \"This number gets along well with your own numbers. It tends to support you.\"\n      },\n      \"found\": 14,\n      \"names\": [\n        {\n          \"name\": \"Jaideep\",\n          \"full_name\": \"Jaideep Doe\",\n          \"devanagari\": \"जयदीप\",\n          \"meaning\": \"Lamp of victory\",\n          \"meaning_known\": true,\n          \"gender\": \"boy\",\n          \"gender_name\": \"Boy\",\n          \"origin\": \"Sanskrit\",\n          \"origin_name\": \"Sanskrit\",\n          \"first_syllable\": \"ज\",\n          \"variants\": [],\n          \"number\": 5,\n          \"first_name_number\": 7,\n          \"needs_check\": false\n        },\n        {\n          \"name\": \"Jainendra\",\n          \"full_name\": \"Jainendra Doe\",\n          \"devanagari\": \"जैनेंद्र\",\n          \"meaning\": \"Lord of the Jains\",\n          \"meaning_known\": true,\n          \"gender\": \"boy\",\n          \"gender_name\": \"Boy\",\n          \"origin\": \"Hindu\",\n          \"origin_name\": \"Hindu\",\n          \"first_syllable\": \"जै\",\n          \"variants\": [],\n          \"number\": 5,\n          \"first_name_number\": 7,\n          \"needs_check\": false\n        }\n      ]\n    }\n  ],\n  \"per_syllable\": null,\n  \"syllables_without_names\": [],\n  \"syllable_note\": null,\n  \"none\": null,\n  \"ranked\": false,\n  \"list\": {\n    \"reviewed\": false,\n    \"in_list\": 13859,\n    \"suggestable\": 13682,\n    \"kept_out\": {\n      \"sensitive\": 177,\n      \"unreadable\": 0\n    },\n    \"meaning_unknown\": 1373\n  },\n  \"review_note\": \"Our name list is still being checked. A meaning or Hindi spelling may change.\",\n  \"not_claimed_name\": \"A number is one thing to think about, not the only one. Choose a name your family loves and will use every day.\",\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]}]},{"name":"Number checks","description":"Number checks: a mobile, vehicle or house number, several numbers side by side, and a business name with its launch date.","item":[{"name":"Mobile, vehicle, house or business number","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/number","host":["{{baseUrl}}"],"path":["v1","number"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Adds up a mobile, vehicle or house number. Only digits count: letters are listed in `ignored_letters` and not counted. A business name is read by its letters instead. Then it gives the `fit` with the owner's mulank and bhagyank, by the same rule as the name checker.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"kind\": \"mobile\",\n  \"value\": \"212 555 0147\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/number","host":["{{baseUrl}}"],"path":["v1","number"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Adds up a mobile, vehicle or house number. Only digits count: letters are listed in `ignored_letters` and not counted. A business name is read by its letters instead. Then it gives the `fit` with the owner's mulank and bhagyank, by the same rule as the name checker.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"kind\": \"mobile\",\n  \"value\": \"212 555 0147\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"kind\": \"mobile\",\n  \"kind_name\": \"Mobile number\",\n  \"about\": \"A mobile number is read by adding all its digits.\",\n  \"value\": \"212 555 0147\",\n  \"digits\": \"2125550147\",\n  \"total\": 32,\n  \"compound\": 32,\n  \"number\": 5,\n  \"ignored_letters\": [],\n  \"planet\": \"Mercury\",\n  \"planet_name\": \"Mercury\",\n  \"person\": {\n    \"birth_date\": \"1990-08-15\",\n    \"mulank\": 6,\n    \"bhagyank\": 6\n  },\n  \"fit\": {\n    \"number\": 5,\n    \"links\": [\n      {\n        \"from\": \"mulank\",\n        \"from_number\": 6,\n        \"to_number\": 5,\n        \"relation\": \"friend\",\n        \"via\": [],\n        \"from_name\": \"mulank\",\n        \"relation_name\": \"friendly\"\n      },\n      {\n        \"from\": \"bhagyank\",\n        \"from_number\": 6,\n        \"to_number\": 5,\n        \"relation\": \"friend\",\n        \"via\": [],\n        \"from_name\": \"bhagyank\",\n        \"relation_name\": \"friendly\"\n      }\n    ],\n    \"outcome\": \"good\",\n    \"outcome_name\": \"Good fit\",\n    \"reading\": \"This number gets along well with your own numbers. It tends to support you.\"\n  },\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"Compare several numbers","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/numbers","host":["{{baseUrl}}"],"path":["v1","numbers"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Up to 5 mobile, vehicle or house numbers of one kind, each read exactly as the number route reads one. In the order given, **never ranked** (`ranked: false`): choosing a number is the person's call.\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"kind\": \"mobile\",\n  \"values\": [\n    \"212 555 0147\",\n    \"212 555 0199\"\n  ],\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/numbers","host":["{{baseUrl}}"],"path":["v1","numbers"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Up to 5 mobile, vehicle or house numbers of one kind, each read exactly as the number route reads one. In the order given, **never ranked** (`ranked: false`): choosing a number is the person's call.\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"kind\": \"mobile\",\n  \"values\": [\n    \"212 555 0147\",\n    \"212 555 0199\"\n  ],\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"kind\": \"mobile\",\n  \"kind_name\": \"Mobile number\",\n  \"person\": {\n    \"birth_date\": \"1990-08-15\",\n    \"mulank\": 6,\n    \"bhagyank\": 6\n  },\n  \"checks\": [\n    {\n      \"kind\": \"mobile\",\n      \"kind_name\": \"Mobile number\",\n      \"about\": \"A mobile number is read by adding all its digits.\",\n      \"value\": \"212 555 0147\",\n      \"digits\": \"2125550147\",\n      \"total\": 32,\n      \"compound\": 32,\n      \"number\": 5,\n      \"ignored_letters\": [],\n      \"planet\": \"Mercury\",\n      \"planet_name\": \"Mercury\",\n      \"person\": {\n        \"birth_date\": \"1990-08-15\",\n        \"mulank\": 6,\n        \"bhagyank\": 6\n      },\n      \"fit\": {\n        \"number\": 5,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 6,\n            \"to_number\": 5,\n            \"relation\": \"friend\",\n            \"via\": [],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"friendly\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 6,\n            \"to_number\": 5,\n            \"relation\": \"friend\",\n            \"via\": [],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"friendly\"\n          }\n        ],\n        \"outcome\": \"good\",\n        \"outcome_name\": \"Good fit\",\n        \"reading\": \"This number gets along well with your own numbers. It tends to support you.\"\n      },\n      \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n      \"localization\": {\n        \"lang\": \"en\",\n        \"detail\": \"standard\",\n        \"fell_back_to_en\": [],\n        \"fell_back_to_standard\": []\n      }\n    },\n    {\n      \"kind\": \"mobile\",\n      \"kind_name\": \"Mobile number\",\n      \"about\": \"A mobile number is read by adding all its digits.\",\n      \"value\": \"212 555 0199\",\n      \"digits\": \"2125550199\",\n      \"total\": 39,\n      \"compound\": 39,\n      \"number\": 3,\n      \"ignored_letters\": [],\n      \"planet\": \"Jupiter\",\n      \"planet_name\": \"Jupiter\",\n      \"person\": {\n        \"birth_date\": \"1990-08-15\",\n        \"mulank\": 6,\n        \"bhagyank\": 6\n      },\n      \"fit\": {\n        \"number\": 3,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 6,\n            \"to_number\": 3,\n            \"relation\": \"neutral\",\n            \"via\": [],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"neutral\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 6,\n            \"to_number\": 3,\n            \"relation\": \"neutral\",\n            \"via\": [],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"neutral\"\n          }\n        ],\n        \"outcome\": \"neutral\",\n        \"outcome_name\": \"Neutral\",\n        \"reading\": \"This number is neutral to your own numbers. It neither helps nor gets in the way much.\"\n      },\n      \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n      \"localization\": {\n        \"lang\": \"en\",\n        \"detail\": \"standard\",\n        \"fell_back_to_en\": [],\n        \"fell_back_to_standard\": []\n      }\n    }\n  ],\n  \"ranked\": false,\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"Business name and launch date","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/business","host":["{{baseUrl}}"],"path":["v1","business"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"A business name read against its owner (Chaldean, as a name). It also gives up to 5 spellings of its first word that sound the same and suit the owner. When `launch_date` is given, it shows how that date's number suits the owner. Same rules as the name checker and the number checker.\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"Acme Inc.\",\n  \"birth_date\": \"1990-08-15\",\n  \"launch_date\": \"2026-12-12\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/business","host":["{{baseUrl}}"],"path":["v1","business"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"A business name read against its owner (Chaldean, as a name). It also gives up to 5 spellings of its first word that sound the same and suit the owner. When `launch_date` is given, it shows how that date's number suits the owner. Same rules as the name checker and the number checker.\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"Acme Inc.\",\n  \"birth_date\": \"1990-08-15\",\n  \"launch_date\": \"2026-12-12\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"name\": {\n    \"kind\": \"business\",\n    \"kind_name\": \"Business name\",\n    \"about\": \"A business name is read from its letters, the same way as a person's name.\",\n    \"value\": \"Acme Inc.\",\n    \"name\": \"Acme Inc.\",\n    \"total\": 22,\n    \"compound\": 22,\n    \"number\": 4,\n    \"master\": true,\n    \"planet\": \"Rahu\",\n    \"planet_name\": \"Rahu\",\n    \"person\": {\n      \"birth_date\": \"1990-08-15\",\n      \"mulank\": 6,\n      \"bhagyank\": 6\n    },\n    \"fit\": {\n      \"number\": 4,\n      \"links\": [\n        {\n          \"from\": \"mulank\",\n          \"from_number\": 6,\n          \"to_number\": 4,\n          \"relation\": \"friend\",\n          \"via\": [\n            \"Rahu\"\n          ],\n          \"from_name\": \"mulank\",\n          \"relation_name\": \"friendly\"\n        },\n        {\n          \"from\": \"bhagyank\",\n          \"from_number\": 6,\n          \"to_number\": 4,\n          \"relation\": \"friend\",\n          \"via\": [\n            \"Rahu\"\n          ],\n          \"from_name\": \"bhagyank\",\n          \"relation_name\": \"friendly\"\n        }\n      ],\n      \"outcome\": \"good\",\n      \"outcome_name\": \"Good fit\",\n      \"reading\": \"This number gets along well with your own numbers. It tends to support you.\"\n    },\n    \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n    \"localization\": {\n      \"lang\": \"en\",\n      \"detail\": \"standard\",\n      \"fell_back_to_en\": [],\n      \"fell_back_to_standard\": []\n    }\n  },\n  \"suggestions\": [\n    {\n      \"name\": \"Aacme Inc.\",\n      \"word\": \"Aacme\",\n      \"changes\": [\n        {\n          \"code\": \"double_a\",\n          \"from\": \"a\",\n          \"to\": \"aa\",\n          \"at\": 0,\n          \"name\": \"Doubled an a\"\n        }\n      ],\n      \"total\": 23,\n      \"compound\": 23,\n      \"number\": 5,\n      \"planet\": \"Mercury\",\n      \"planet_name\": \"Mercury\",\n      \"fit\": {\n        \"number\": 5,\n        \"links\": [\n          {\n            \"from\": \"mulank\",\n            \"from_number\": 6,\n            \"to_number\": 5,\n            \"relation\": \"friend\",\n            \"via\": [],\n            \"from_name\": \"mulank\",\n            \"relation_name\": \"friendly\"\n          },\n          {\n            \"from\": \"bhagyank\",\n            \"from_number\": 6,\n            \"to_number\": 5,\n            \"relation\": \"friend\",\n            \"via\": [],\n            \"from_name\": \"bhagyank\",\n            \"relation_name\": \"friendly\"\n          }\n        ],\n        \"outcome\": \"good\",\n        \"outcome_name\": \"Good fit\",\n        \"reading\": \"This number gets along well with your own numbers. It tends to support you.\"\n      }\n    }\n  ],\n  \"found\": 1,\n  \"suggest_about\": \"These spellings sound the same as your name but add up to a number that suits you. Only small, common spelling changes are tried.\",\n  \"not_claimed_spelling\": \"A new spelling changes the number of the name, not the person. Choose one only if you are happy to use it every day.\",\n  \"launch\": {\n    \"date\": \"2026-12-12\",\n    \"number\": 7,\n    \"planet\": \"Ketu\",\n    \"planet_name\": \"Ketu\",\n    \"fit\": {\n      \"number\": 7,\n      \"links\": [\n        {\n          \"from\": \"mulank\",\n          \"from_number\": 6,\n          \"to_number\": 7,\n          \"relation\": \"neutral\",\n          \"via\": [\n            \"Ketu\"\n          ],\n          \"from_name\": \"mulank\",\n          \"relation_name\": \"neutral\"\n        },\n        {\n          \"from\": \"bhagyank\",\n          \"from_number\": 6,\n          \"to_number\": 7,\n          \"relation\": \"neutral\",\n          \"via\": [\n            \"Ketu\"\n          ],\n          \"from_name\": \"bhagyank\",\n          \"relation_name\": \"neutral\"\n        }\n      ],\n      \"outcome\": \"neutral\",\n      \"outcome_name\": \"Neutral\",\n      \"reading\": \"This number is neutral to your own numbers. It neither helps nor gets in the way much.\"\n    },\n    \"about\": \"A launch date adds up to its own number. It is read against the owner's mulank and bhagyank.\"\n  },\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]}]},{"name":"Compatibility","description":"Two people's numbers, read both ways.","item":[{"name":"Two people","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/compatibility","host":["{{baseUrl}}"],"path":["v1","compatibility"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"How two people's numbers get along: each one's mulank and bhagyank, read both ways, since the friendship of numbers is one-sided. `outcome` uses the same rule as the name checker over all four relations. Nothing is scored.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"a\": {\n    \"birth_date\": \"1990-08-15\"\n  },\n  \"b\": {\n    \"birth_date\": \"1992-03-22\"\n  }\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/compatibility","host":["{{baseUrl}}"],"path":["v1","compatibility"],"query":[{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"How two people's numbers get along: each one's mulank and bhagyank, read both ways, since the friendship of numbers is one-sided. `outcome` uses the same rule as the name checker over all four relations. Nothing is scored.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"a\": {\n    \"birth_date\": \"1990-08-15\"\n  },\n  \"b\": {\n    \"birth_date\": \"1992-03-22\"\n  }\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"a\": {\n    \"birth_date\": \"1990-08-15\",\n    \"mulank\": 6,\n    \"bhagyank\": 6,\n    \"mulank_planet\": \"Venus\"\n  },\n  \"b\": {\n    \"birth_date\": \"1992-03-22\",\n    \"mulank\": 4,\n    \"bhagyank\": 1,\n    \"mulank_planet\": \"Rahu\"\n  },\n  \"links\": [\n    {\n      \"from\": \"mulank\",\n      \"from_number\": 6,\n      \"to_number\": 4,\n      \"relation\": \"friend\",\n      \"via\": [\n        \"Rahu\"\n      ],\n      \"who\": \"a_to_b\",\n      \"from_name\": \"mulank\",\n      \"relation_name\": \"friendly\"\n    },\n    {\n      \"from\": \"mulank\",\n      \"from_number\": 4,\n      \"to_number\": 6,\n      \"relation\": \"friend\",\n      \"via\": [\n        \"Rahu\"\n      ],\n      \"who\": \"b_to_a\",\n      \"from_name\": \"mulank\",\n      \"relation_name\": \"friendly\"\n    }\n  ],\n  \"outcome\": \"mixed\",\n  \"outcome_name\": \"Mixed\",\n  \"reading\": \"Your numbers pull both ways. Some things come easily between you and some need patience.\",\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]}]},{"name":"Western numbers","description":"The Western (Pythagorean) numbers: life path, expression, soul urge, personality, maturity, birthday, karmic debt and lessons, challenges and pinnacles.","item":[{"name":"Western numbers","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/western?as_of=2026-10-01","host":["{{baseUrl}}"],"path":["v1","western"],"query":[{"key":"as_of","value":"2026-10-01","description":"The date to read the personal year, month and day (and the current pinnacle and life cycle) for, `YYYY-MM-DD`. Defaults to today. Echoed back in `as_of`.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"The Western (Pythagorean) numbers: **life path**, **expression**, **soul urge**, **personality**, **maturity** and **birthday**. It also returns karmic debt, karmic lessons, hidden passion and balance. It returns the four **challenges** and the four **pinnacles**, with ages, years and which one is `current`, and the three **life cycles** (early, middle and later years) the same way. It also returns the personal year, month and day. Master numbers 11, 22 and 33 are kept in `number`; `digit` is the same number reduced to 1-9. `basis` states each method where books differ. Use the full name from birth.\n\n**Uses 3 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/western?as_of=2026-10-01","host":["{{baseUrl}}"],"path":["v1","western"],"query":[{"key":"as_of","value":"2026-10-01","description":"The date to read the personal year, month and day (and the current pinnacle and life cycle) for, `YYYY-MM-DD`. Defaults to today. Echoed back in `as_of`.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"The Western (Pythagorean) numbers: **life path**, **expression**, **soul urge**, **personality**, **maturity** and **birthday**. It also returns karmic debt, karmic lessons, hidden passion and balance. It returns the four **challenges** and the four **pinnacles**, with ages, years and which one is `current`, and the three **life cycles** (early, middle and later years) the same way. It also returns the personal year, month and day. Master numbers 11, 22 and 33 are kept in `number`; `digit` is the same number reduced to 1-9. `basis` states each method where books differ. Use the full name from birth.\n\n**Uses 3 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"name\": \"John Doe\",\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"input\": {\n    \"name\": \"John Doe\",\n    \"birth_date\": \"1990-08-15\"\n  },\n  \"system\": \"pythagorean\",\n  \"about\": \"These are the Western numbers. They use the Pythagorean letter values, where A is 1, B is 2 and so on. The numbers 11, 22 and 33 are master numbers and are…\",\n  \"basis\": {\n    \"letters\": \"Pythagorean letter values (A=1 ... I=9, J=1 ...).\",\n    \"masters\": \"11, 22 and 33 are kept; `digit` is the same number reduced to 1-9.\",\n    \"life_path\": \"Month, day and year are reduced one by one, then added.\",\n    \"name_numbers\": \"Each word is reduced, then the words are added.\",\n    \"y\": \"Y counts as a vowel when neither letter beside it is a vowel.\",\n    \"personal_year\": \"Counted on the calendar year, from January 1.\",\n    \"pinnacles\": \"The first ends at age 36 minus the life path digit; each later one lasts nine years, and the fourth for life.\",\n    \"life_cycles\": \"Month, day and year, each reduced (masters kept). The first cycle ends with the first pinnacle, the second 27 years later, and the third runs for life.\",\n    \"karmic_debt\": \"Karmic debt is looked for in six numbers: life path, expression, soul urge, personality, maturity and birthday. Pinnacles, challenges and life cycles are not…\"\n  },\n  \"life_path\": {\n    \"total\": 15,\n    \"number\": 6,\n    \"digit\": 6,\n    \"karmic_debt\": [],\n    \"parts\": {\n      \"month\": 8,\n      \"day\": 6,\n      \"year\": 1\n    },\n    \"about\": \"Your life path number comes from your full birth date. It shows the main road your life tends to follow.\",\n    \"reading\": \"Your road tends to center on caring for others. Family, home and community often matter most to you.\"\n  },\n  \"expression\": {\n    \"total\": 8,\n    \"number\": 8,\n    \"digit\": 8,\n    \"karmic_debt\": [],\n    \"words\": [\n      20,\n      15\n    ],\n    \"about\": \"Your expression number comes from every letter of your full name. It shows your natural talents.\",\n    \"reading\": \"You have a natural gift for business, managing and handling money.\"\n  },\n  \"soul_urge\": {\n    \"total\": 17,\n    \"number\": 8,\n    \"digit\": 8,\n    \"karmic_debt\": [],\n    \"words\": [\n      6,\n      11\n    ],\n    \"about\": \"Your soul urge number comes from the vowels in your name. It shows what you want deep inside.\",\n    \"reading\": \"Deep inside, you want success and to be respected for what you achieve.\"\n  },\n  \"personality\": {\n    \"total\": 9,\n    \"number\": 9,\n    \"digit\": 9,\n    \"karmic_debt\": [\n      {\n        \"number\": 14,\n        \"reading\": \"14 points to a lesson about balance. Too much of anything, from food to freedom, tends to cost you.\"\n      }\n    ],\n    \"words\": [\n      14,\n      4\n    ],\n    \"about\": \"Your personality number comes from the consonants in your name. It shows how people see you before they know you well.\",\n    \"reading\": \"People tend to see you as open-hearted and generous.\"\n  },\n  \"maturity\": {\n    \"total\": 14,\n    \"number\": 5,\n    \"digit\": 5,\n    \"karmic_debt\": [\n      {\n        \"number\": 14,\n        \"reading\": \"14 points to a lesson about balance. Too much of anything, from food to freedom, tends to cost you.\"\n      }\n    ],\n    \"about\": \"Your maturity number adds your life path and expression numbers. It shows what tends to grow stronger after about age 35.\",\n    \"reading\": \"After about age 35, you tend to want more freedom and change. New places, people and ideas often keep you growing.\"\n  },\n  \"birthday\": {\n    \"day\": 15,\n    \"number\": 6,\n    \"digit\": 6,\n    \"karmic_debt\": [],\n    \"about\": \"Your birthday number is the day of the month you were born. It shows one special gift you carry.\",\n    \"reading\": \"You tend to have a special gift for caring for others. You may be good at looking after people and making any place feel like home.\"\n  },\n  \"karmic_lessons\": {\n    \"about\": \"Karmic lessons are the numbers from 1 to 9 that no letter of your name gives. They show skills you may need to build on purpose.\",\n    \"numbers\": [\n      {\n        \"number\": 2,\n        \"reading\": \"No letter gives 2. Patience and working closely with others may need practice.\"\n      },\n      {\n        \"number\": 3,\n        \"reading\": \"No letter gives 3. Sharing your feelings and ideas out loud may need practice.\"\n      }\n    ]\n  },\n  \"hidden_passion\": {\n    \"numbers\": [\n      5,\n      6\n    ],\n    \"count\": 2,\n    \"about\": \"Your hidden passion is the number that appears most often in the letters of your name. It shows a strong drive you may not talk about.\",\n    \"readings\": [\n      \"5 is about freedom, change, travel and trying new things.\",\n      \"6 is about care, family, home and taking responsibility.\"\n    ]\n  },\n  \"balance\": {\n    \"initials\": \"JD\",\n    \"total\": 5,\n    \"number\": 5,\n    \"about\": \"Your balance number comes from the first letter of each part of your name. It shows how you tend to handle hard times.\",\n    \"reading\": \"5 is about freedom, change, travel and trying new things.\"\n  },\n  \"challenges\": {\n    \"about\": \"Your four challenge numbers come from your birth date. Each shows something you may have to work at during part of your life.\",\n    \"items\": [\n      {\n        \"id\": \"first\",\n        \"number\": 2,\n        \"name\": \"First challenge\",\n        \"reading\": \"Not taking things too personally.\"\n      },\n      {\n        \"id\": \"second\",\n        \"number\": 5,\n        \"name\": \"Second challenge\",\n        \"reading\": \"Handling freedom wisely and not rushing from one thing to the next.\"\n      }\n    ]\n  },\n  \"pinnacles\": {\n    \"about\": \"Your four pinnacles are long stretches of your life. Each one has its own number and its own focus.\",\n    \"as_of\": \"2026-10-01\",\n    \"items\": [\n      {\n        \"id\": 1,\n        \"number\": 5,\n        \"digit\": 5,\n        \"from_age\": 0,\n        \"to_age\": 30,\n        \"from_year\": 1990,\n        \"to_year\": 2020,\n        \"current\": false,\n        \"reading\": \"5 is about freedom, change, travel and trying new things.\"\n      },\n      {\n        \"id\": 2,\n        \"number\": 7,\n        \"digit\": 7,\n        \"from_age\": 31,\n        \"to_age\": 39,\n        \"from_year\": 2021,\n        \"to_year\": 2029,\n        \"current\": true,\n        \"reading\": \"7 is about study, thinking deeply and looking inward.\"\n      }\n    ]\n  },\n  \"life_cycles\": {\n    \"about\": \"Your life cycles are three long stages of your life: your early, middle and later years. Each stage has its own number and its own mood.\",\n    \"as_of\": \"2026-10-01\",\n    \"items\": [\n      {\n        \"id\": \"early\",\n        \"number\": 8,\n        \"digit\": 8,\n        \"from_age\": 0,\n        \"to_age\": 30,\n        \"from_year\": 1990,\n        \"to_year\": 2020,\n        \"current\": false,\n        \"name\": \"Early years\",\n        \"reading\": \"8 is about ambition, money, managing people and real results.\"\n      },\n      {\n        \"id\": \"middle\",\n        \"number\": 6,\n        \"digit\": 6,\n        \"from_age\": 31,\n        \"to_age\": 57,\n        \"from_year\": 2021,\n        \"to_year\": 2047,\n        \"current\": true,\n        \"name\": \"Middle years\",\n        \"reading\": \"6 is about care, family, home and taking responsibility.\"\n      }\n    ]\n  },\n  \"personal\": {\n    \"as_of\": \"2026-10-01\",\n    \"year\": {\n      \"number\": 6,\n      \"about\": \"Your personal year number shows the theme of this year for you. It changes on January 1.\",\n      \"reading\": \"A year for home, family and duties. People may lean on you.\",\n      \"do\": \"Give time to your home and family. Help the people who lean on you, and plan what you can do for them. Fix or improve something at home. Spend time with your…\",\n      \"avoid\": \"Avoid taking on every duty yourself. Try not to give advice or help where it is not wanted. Do not forget your own rest while you care for others. Avoid…\"\n    },\n    \"month\": {\n      \"number\": 7,\n      \"about\": \"Your personal month number shows the theme of this month for you.\",\n      \"reading\": \"This month tends to favor rest, study and thinking things over. You may want more quiet time than usual. It is a good time to read, plan and look inward,…\"\n    },\n    \"day\": {\n      \"number\": 8,\n      \"about\": \"Your personal day number shows the theme of this day for you.\",\n      \"reading\": \"Good for work, money and big decisions.\"\n    }\n  },\n  \"not_computed\": [],\n  \"not_claimed_karmic\": \"Karmic debt and karmic lessons describe patterns to work on. They are not a claim about a past life.\",\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]}]},{"name":"Dates and cycles","description":"Dates and cycles: the personal year, month and day, the good dates in a month, a calendar year for a mulank, and the number of any day.","item":[{"name":"Personal year, month and day","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/cycles?as_of=2026-10-01","host":["{{baseUrl}}"],"path":["v1","cycles"],"query":[{"key":"as_of","value":"2026-10-01","description":"The date to read the personal year, month and day (and the current pinnacle and life cycle) for, `YYYY-MM-DD`. Defaults to today. Echoed back in `as_of`.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"The personal year, month and day for one date, each with a short reading. Needs only the birth date, so it suits a daily screen. The personal year changes on January 1.\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/cycles?as_of=2026-10-01","host":["{{baseUrl}}"],"path":["v1","cycles"],"query":[{"key":"as_of","value":"2026-10-01","description":"The date to read the personal year, month and day (and the current pinnacle and life cycle) for, `YYYY-MM-DD`. Defaults to today. Echoed back in `as_of`.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"The personal year, month and day for one date, each with a short reading. Needs only the birth date, so it suits a daily screen. The personal year changes on January 1.\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"birth_date\": \"1990-08-15\",\n  \"as_of\": \"2026-10-01\",\n  \"year\": {\n    \"number\": 6,\n    \"about\": \"Your personal year number shows the theme of this year for you. It changes on January 1.\",\n    \"reading\": \"A year for home, family and duties. People may lean on you.\",\n    \"do\": \"Give time to your home and family. Help the people who lean on you, and plan what you can do for them. Fix or improve something at home. Spend time with your…\",\n    \"avoid\": \"Avoid taking on every duty yourself. Try not to give advice or help where it is not wanted. Do not forget your own rest while you care for others. Avoid…\"\n  },\n  \"month\": {\n    \"number\": 7,\n    \"about\": \"Your personal month number shows the theme of this month for you.\",\n    \"reading\": \"This month tends to favor rest, study and thinking things over. You may want more quiet time than usual. It is a good time to read, plan and look inward,…\"\n  },\n  \"day\": {\n    \"number\": 8,\n    \"about\": \"Your personal day number shows the theme of this day for you.\",\n    \"reading\": \"Good for work, money and big decisions.\"\n  },\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"A year for a mulank","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/year/:mulank?year=2026","host":["{{baseUrl}}"],"path":["v1","year",":mulank"],"query":[{"key":"year","value":"2026","description":"The calendar year. Defaults to this year.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[{"key":"mulank","value":"4","description":"The mulank, from 1 to 9."}]},"description":"A calendar year read for one mulank, with no birth date. The year adds up to one number, the same for everyone (2027 adds up to 11, then 2). `year_number` says how the mulank gets along with it. It uses the same one-sided planet friendship as the rest of the API, so `outcome` is `good`, `neutral` or `difficult`. `months` reads each month the same way (the year's number plus the month).\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits)."},"response":[{"name":"Example answer","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/year/:mulank?year=2026","host":["{{baseUrl}}"],"path":["v1","year",":mulank"],"query":[{"key":"year","value":"2026","description":"The calendar year. Defaults to this year.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[{"key":"mulank","value":"4","description":"The mulank, from 1 to 9."}]},"description":"A calendar year read for one mulank, with no birth date. The year adds up to one number, the same for everyone (2027 adds up to 11, then 2). `year_number` says how the mulank gets along with it. It uses the same one-sided planet friendship as the rest of the API, so `outcome` is `good`, `neutral` or `difficult`. `months` reads each month the same way (the year's number plus the month).\n\n**Uses 2 reading credits.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits)."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"mulank\": 4,\n  \"mulank_planet\": \"Rahu\",\n  \"mulank_planet_name\": \"Rahu\",\n  \"year\": 2026,\n  \"about\": \"Every calendar year adds up to one number, the same for everyone. For example, 2027 adds up to 11, then to 2. How your mulank gets along with that number…\",\n  \"year_number\": {\n    \"number\": 1,\n    \"planet\": \"Sun\",\n    \"planet_name\": \"Sun\",\n    \"relation\": \"enemy\",\n    \"via\": [\n      \"Rahu\"\n    ],\n    \"outcome\": \"difficult\",\n    \"relation_name\": \"unfriendly\",\n    \"outcome_name\": \"Not a good fit\",\n    \"reading\": \"Your mulank does not get along easily with this year's number. Things may take more effort or patience. Plan carefully and do not rush big decisions.\",\n    \"theme\": \"A year that adds up to 1 tends to favor new starts, bold moves and standing on your own.\"\n  },\n  \"months\": [\n    {\n      \"month\": 1,\n      \"month_name\": \"January\",\n      \"number\": 2,\n      \"planet\": \"Moon\",\n      \"planet_name\": \"Moon\",\n      \"outcome\": \"difficult\",\n      \"outcome_name\": \"Not a good fit\",\n      \"theme\": \"Good for teamwork and quiet patience.\"\n    },\n    {\n      \"month\": 2,\n      \"month_name\": \"February\",\n      \"number\": 3,\n      \"planet\": \"Jupiter\",\n      \"planet_name\": \"Jupiter\",\n      \"outcome\": \"neutral\",\n      \"outcome_name\": \"Neutral\",\n      \"theme\": \"Good for meeting people and sharing ideas.\"\n    }\n  ],\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"A day's number","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/day?date=2026-10-01","host":["{{baseUrl}}"],"path":["v1","day"],"query":[{"key":"date","value":"2026-10-01","description":"The date, `YYYY-MM-DD`. Defaults to today.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"A date's number (every digit added, the same for everyone) and its theme. It also shows how each of the nine mulanks gets along with it. `mulanks[]` gives each one's `outcome` (`good`, `neutral` or `difficult`) and a one-line reading. No birth date needed. For a personal day, use the cycles route.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits)."},"response":[{"name":"Example answer","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/day?date=2026-10-01","host":["{{baseUrl}}"],"path":["v1","day"],"query":[{"key":"date","value":"2026-10-01","description":"The date, `YYYY-MM-DD`. Defaults to today.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"A date's number (every digit added, the same for everyone) and its theme. It also shows how each of the nine mulanks gets along with it. `mulanks[]` gives each one's `outcome` (`good`, `neutral` or `difficult`) and a one-line reading. No birth date needed. For a personal day, use the cycles route.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits)."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"date\": \"2026-10-01\",\n  \"number\": 3,\n  \"planet\": \"Jupiter\",\n  \"planet_name\": \"Jupiter\",\n  \"about\": \"Every date adds up to one number, the same for everyone. How your mulank gets along with today's number shows whether the day tends to suit you.\",\n  \"theme\": \"Good for meeting people and sharing ideas.\",\n  \"mulanks\": [\n    {\n      \"mulank\": 1,\n      \"mulank_planet\": \"Sun\",\n      \"mulank_planet_name\": \"Sun\",\n      \"relation\": \"friend\",\n      \"via\": [],\n      \"outcome\": \"good\",\n      \"relation_name\": \"friendly\",\n      \"outcome_name\": \"Good fit\",\n      \"reading\": \"A good day for you. Use it for things that matter.\"\n    },\n    {\n      \"mulank\": 2,\n      \"mulank_planet\": \"Moon\",\n      \"mulank_planet_name\": \"Moon\",\n      \"relation\": \"neutral\",\n      \"via\": [],\n      \"outcome\": \"neutral\",\n      \"relation_name\": \"neutral\",\n      \"outcome_name\": \"Neutral\",\n      \"reading\": \"An ordinary day for you. Keep to your plans.\"\n    }\n  ],\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]},{"name":"Good dates in a month","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/dates?month=2026-10","host":["{{baseUrl}}"],"path":["v1","dates"],"query":[{"key":"month","value":"2026-10","description":"The month, `YYYY-MM`. Defaults to this month.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Every date of a month read for one person. The date's own number (every digit added) is read against their mulank and bhagyank. It uses the same rule as a phone number, so `outcome` is `good`, `neutral`, `mixed` or `difficult`. `good` lists the good dates. Each day also carries `personal_day` (1-9) as a theme; it is not judged.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Example answer","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/dates?month=2026-10","host":["{{baseUrl}}"],"path":["v1","dates"],"query":[{"key":"month","value":"2026-10","description":"The month, `YYYY-MM`. Defaults to this month.","disabled":false},{"key":"lang","value":"en","description":"Language of the readings and names: `en`, `hi`. Codes stay in English.","disabled":true},{"key":"detail","value":"standard","description":"Length of the readings: `standard` (the default, short, for app cards) or `expanded` (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in `localization.fell_back_to_standard`.","disabled":true}],"variable":[]},"description":"Every date of a month read for one person. The date's own number (every digit added) is read against their mulank and bhagyank. It uses the same rule as a phone number, so `outcome` is `good`, `neutral`, `mixed` or `difficult`. `good` lists the good dates. Each day also carries `personal_day` (1-9) as a theme; it is not judged.\n\n**Uses 1 reading credit.** On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. [What reading credits buy](https://apiforastrology.com/pricing#reading-credits).","body":{"mode":"raw","raw":"{\n  \"birth_date\": \"1990-08-15\"\n}","options":{"raw":{"language":"json"}}}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"person\": {\n    \"birth_date\": \"1990-08-15\",\n    \"mulank\": 6,\n    \"bhagyank\": 6\n  },\n  \"year\": 2026,\n  \"month\": 10,\n  \"month_name\": \"October\",\n  \"about\": \"Each date adds up to its own number. Here every date of the month is read against your mulank and bhagyank, the same way a phone number is.\",\n  \"rule\": \"A good date is one whose number gets along well with your own numbers and does not clash with either.\",\n  \"days\": [\n    {\n      \"date\": \"2026-10-01\",\n      \"day\": 1,\n      \"weekday\": 4,\n      \"number\": 3,\n      \"planet\": \"Jupiter\",\n      \"planet_name\": \"Jupiter\",\n      \"outcome\": \"neutral\",\n      \"outcome_name\": \"Neutral\",\n      \"personal_day\": 8\n    },\n    {\n      \"date\": \"2026-10-02\",\n      \"day\": 2,\n      \"weekday\": 5,\n      \"number\": 4,\n      \"planet\": \"Rahu\",\n      \"planet_name\": \"Rahu\",\n      \"outcome\": \"good\",\n      \"outcome_name\": \"Good fit\",\n      \"personal_day\": 9\n    }\n  ],\n  \"good\": [\n    2,\n    3\n  ],\n  \"none\": null,\n  \"not_claimed\": \"Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.\",\n  \"localization\": {\n    \"lang\": \"en\",\n    \"detail\": \"standard\",\n    \"fell_back_to_en\": [],\n    \"fell_back_to_standard\": []\n  }\n}"}]}]}]}