---
title: "Mobile Number Numerology (deprecated GET)"
method: GET
path: "/v1/numerology/mobile-number"
tags: ["Numerology"]
deprecated: true
---

# Mobile Number Numerology (deprecated GET)

`GET /v1/numerology/mobile-number`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/mobile-number`
- Auth: HTTP bearer

> **Deprecated.**

Deprecated: send the mobile number in a JSON body with POST /v1/numerology/mobile-number instead, so it stays out of URLs and logs. This GET form keeps working for at least 12 months and answers with a `Deprecation` header.

## Query parameters

- `number` string, required: Mobile number (digits only or with country code; the country code is not counted)
- `country` string, nullable: 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 `200`

Successful Response

- ApiResponseDigitNumberAnalysisResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` DigitNumberAnalysisResponse, required: Mobile or vehicle number analysis (digit-sum reduction).
    - `input` string, required
    - `input_type` string, required
    - `total` integer, required: Sum of the digits in digits_used
    - `single_digit` integer, required: Total reduced to 1-9 (master totals reduce too, e.g. 11 → 2)
    - `is_master` boolean, required: True when the total, or a step of its reduction, is 11, 22 or 33
    - `master_number` integer, nullable: The master number (11, 22 or 33) met while reducing the total; omitted when none
    - `digits_used` string, nullable: Digits that were summed. Mobile: the national number without the country code (e.g. '+91 98765 43210' → '9876543210'). Vehicle: every digit on the plate.
    - `country_code` integer, nullable: Mobile only: country calling code that was recognised and left out of the sum
    - `theme` string, required
    - `favourable_for` string[], required
    - `caution` string, required
    - `harmony_score` integer, required

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)