GET/v1/numerology/mobile-number

Mobile Number Numerology

Analyses a mobile/phone number numerologically. Sums all digits to a single number and returns theme, harmony score, and recommended uses.

Request parameters

numberrequired

string

Mobile number (digits only or with country code)

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

data.single_digit

integer

data.is_master

boolean

data.theme

string

data.favourable_for

array[string]

data.caution

string

data.harmony_score

integer

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Business Name Numerology
• Business Name Numerology (JSON body)
• Vehicle Number Numerology

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/numerology/mobile-number?number=%2B919876543210" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi

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

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.mobile_number(number="+919876543210")
    print(result)

TypeScript

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

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

const result = await mobileNumber({
  client,
  query: {
      "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
  }
}