POST · NUMEROLOGY

Personality Number

Endpoint POST https://starsapi.com/api/v3/numerology/western/personality

Derived from the consonants in the full birth name. Shows how others perceive you — the outer personality presented to the world.

Authentication

Required. Three methods accepted:

MethodExample
Header (recommended)X-Api-Key: am_live_xxxxxxxxxxxx
BearerAuthorization: Bearer am_live_xxxxxxxxxxxx
Body"api_key": "am_live_xxxxxxxxxxxx"

Request body

Send a JSON object with Content-Type: application/json.

FieldTypeRequiredDescription
yearintegerYesBirth year, 4-digit (e.g. 1990).
monthintegerYesBirth month, 112.
dayintegerYesDay of month, 131.
namestringYesFull name (first + last). Used for letter-value calculations.
master_numbersbooleanNoPreserve master numbers (11, 22, 33). Default true.

Response

Returns a v3 envelope with data containing the numerology results and meta with request metadata. See the code pane for a sample response.

Errors

HTTPCodeCause
400INPUT_DOB_MISSINGRequired dob field is absent.
400INPUT_NAME_MISSINGRequired name field is absent.
400INPUT_MISSINGOne or more required fields are missing.
400INPUT_INVALIDInput validation failed (bad date format, etc.).
401AUTH_MISSING_KEYNo API key in request.
401AUTH_INVALID_KEYKey format invalid or not found.
405METHOD_NOT_ALLOWEDNon-POST request.
429RATE_LIMIT_EXCEEDEDPlan quota exceeded.
500INTERNAL_ERRORServer error.