---
title: "Vehicle Number Numerology"
method: POST
path: "/v1/numerology/vehicle-number"
tags: ["Numerology"]
---

# Vehicle Number Numerology

`POST /v1/numerology/vehicle-number`

## Request

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

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`.

## Request body

- VehicleNumberRequest: POST body for vehicle number numerology: the plate stays out of the URL.
  - `number` string, required: Vehicle registration number

## 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)