POST/v1/numerology/vehicle-number

Vehicle Number Numerology

Analyses a vehicle registration number numerologically. Body: number. Extracts digits, sums to single number, returns theme and harmony score. is_master / master_number report a total that passes through 11, 22 or 33. A plate with no digits, or only zeros, is rejected with 422 validation_error.

GET is deprecated

GET /v1/numerology/vehicle-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

Vehicle registration number

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
• Mobile Number Numerology

Request

POST·application/json

curl

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

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.vehicle_number_request import VehicleNumberRequest

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

request = VehicleNumberRequest(
    number="MH01AB1234",
)

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

TypeScript

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

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

const result = await vehicleNumberPost({
  client,
  body: {
      "number": "MH01AB1234"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "input": "MH01AB1234",
    "input_type": "vehicle",
    "total": 11,
    "single_digit": 2,
    "is_master": true,
    "theme": "Partnerships & harmony",
    "favourable_for": [
      "partnerships",
      "communication",
      "... and 1 more item"
    ],
    "caution": "May create indecision. Trust your intuition.",
    "harmony_score": 7,
    "master_number": 11,
    "digits_used": "011234"
  }
}