POST · NUMEROLOGY

Life Pinnacles

Endpoint POST https://starsapi.com/api/v3/numerology/forecast/pinnacles

Calculates the four Pinnacle cycles derived from the birth date. Pinnacles represent peak experiences and opportunities at different life stages.

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.

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.