POST/v1/numerology/mobile-number

Mobile Number Numerology

Analyses a mobile/phone number numerologically. Body: number, optional country (ISO 3166 alpha-2). Sums the digits of the national number, country code left out (libphonenumber): with country the number is read as dialled there first, international prefix included; a valid '+' or '00' number drops its country code; a '+' number that is not valid sums every digit after the '+', and a '00' number that is not valid is summed as written; with no prefix and no country, only India's code is removed (a 12-digit number starting 91) and any other number is summed as written, since the country cannot be known. Reduces to a single number and returns theme, harmony score, recommended uses, digits_used, country_code when one was left out, and master_number when the total passes through 11, 22 or 33. A number with no digits, or only zeros, is rejected with 422 validation_error, and so is an unknown country (issue unknown_country, field country).

GET is deprecated

GET /v1/numerology/mobile-number still works for existing integrations but is deprecated since 2026-10-04: it puts personal data in the URL, where logs keep it. Its responses carry a Deprecation header. Use POST as shown here; the answer is the same. It stays available for at least 12 months. See the changelog.

Request parameters

numberrequired

string

Mobile number, digits only or with country code. The country code is not counted: the national number of a valid number is summed (libphonenumber). With country, the number is read as dialled in that country first, including its international prefix (Australia '0011 …', US '011 …'). A '+' number libphonenumber does not accept is summed with every digit after the '+'; a '00' number counts as international only if the rest is a valid number, otherwise it is summed as written. With no prefix and no country, the only code removed is India's (a 12-digit number starting 91), and every other number is summed as written, because the country cannot be known (China '180…' would look like US +1).

countryoptional

string | null

Optional ISO 3166 alpha-2 country the number is dialled in (e.g. 'IN', 'US', 'AU'). The number is parsed in that country first, so a country code or trunk 0 written in front is dropped and that country's international prefix is understood ('14155552671' with 'US' → 4155552671; '0011 61 412 345 678' with 'AU' → 412345678). An unknown code is a 422 validation_error with issue unknown_country on field country.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

Mobile or vehicle number analysis (digit-sum reduction).

data.input

string

data.input_type

string

data.total

integer

Sum of the digits in digits_used

data.single_digit

integer

Total reduced to 1-9 (master totals reduce too, e.g. 11 → 2)

data.is_master

boolean

True when the total, or a step of its reduction, is 11, 22 or 33

data.master_number

integer | null

The master number (11, 22 or 33) met while reducing the total; omitted when none

data.digits_used

string | null

Digits that were summed. Mobile: the national number without the country code (e.g. '+91 98765 43210' → '9876543210'). Vehicle: every digit on the plate.

data.country_code

integer | null

Mobile only: country calling code that was recognised and left out of the sum

data.theme

string

data.favourable_for

array[string]

data.caution

string

data.harmony_score

integer

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Business Name Numerology
• Vehicle Number Numerology

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/numerology/mobile-number" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"+919876543210"}'

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.mobile_number_request import MobileNumberRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = MobileNumberRequest(
    number="+919876543210",
)

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.mobile_number_post(mobile_number_request=request)
    print(result)

TypeScript

import { createClient, createConfig, mobileNumberPost } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await mobileNumberPost({
  client,
  body: {
      "number": "+919876543210"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "input": "+919876543210",
    "input_type": "mobile",
    "total": 45,
    "single_digit": 9,
    "is_master": false,
    "theme": "Completion & universal service",
    "favourable_for": [
      "NGOs",
      "humanitarian",
      "... and 1 more item"
    ],
    "caution": "Endings and completions. Best for final phases.",
    "harmony_score": 7,
    "country_code": 91,
    "digits_used": "9876543210"
  }
}