Balance Number
Calculates the Balance number from the first letter of each name part. Indicates how a person handles stress and unresolved issues.
Endpoint
POST /v1/numerology/balance
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Full name (first and last) |
Example request
- curl
- Python
- TypeScript
curl -X POST "https://api.asterwise.com/v1/numerology/balance" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Arjun Mehta"}'
import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.name_only_request import NameOnlyRequest
configuration = asterwise.Configuration(
host="https://api.asterwise.com",
access_token="YOUR_API_KEY",
)
request = NameOnlyRequest(
name="Arjun Mehta",
)
with asterwise.ApiClient(configuration) as client:
api = NumerologyApi(client)
result = api.balance_number(name_only_request=request)
print(result)
import { createClient, createConfig, balanceNumber } from 'asterwise';
const client = createClient(createConfig({
baseUrl: 'https://api.asterwise.com',
headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));
const result = await balanceNumber({
client,
body: {
"name": "Arjun Mehta"
},
});
console.log(result.data);
Example response
Response fields
| Field | Type | Description |
|---|---|---|
| success | boolean | True if the request succeeded |
| message | string | Human-readable status message |
| data | object | |
| data.number | integer | |
| data.is_master_number | boolean | |
| data.karmic_debt_number | integer | null |
Errors
| Code | Description | Reference |
|---|---|---|
| authentication_failed | Missing or invalid API key. | authentication_failed |
| ephemeris_unavailable | Upstream ephemeris service error. | ephemeris_unavailable |
| insufficient_tier | API key tier does not include this endpoint. | insufficient_tier |
| internal_error | Unexpected server error. | internal_error |
| ip_rate_limit_exceeded | Too many requests in a short window. | ip_rate_limit_exceeded |
| payload_too_large | Request body exceeds the size limit. | payload_too_large |
| resource_not_found | Referenced resource was not found. | resource_not_found |
| validation_error | Request body failed schema validation. | validation_error |