---
title: "Business Name Numerology"
method: POST
path: "/v1/numerology/business-name"
tags: ["Numerology"]
---

# Business Name Numerology

`POST /v1/numerology/business-name`

## Request

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

Scores a business name by its Pythagorean Expression number, with theme, harmony score (1-10) and recommended uses. The number is worked part by part like /v1/numerology/expression: each word is reduced on its own (11, 22, 33 kept), then the words are added and reduced. A name with no letters (e.g. '123') is rejected with 422 `validation_error`.

## Request body

- BusinessNamePostRequest
  - `name` string, required: Business name to analyse

## Response `200`

Successful Response

- ApiResponseBusinessNameAnalysisResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` BusinessNameAnalysisResponse, required
    - `input` string, required
    - `input_type` string, required
    - `expression_number` integer, required
    - `single_digit` integer, required
    - `is_master` boolean, required
    - `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)