title: "Personal Archetype Stack" description: Developer documentation for the Personal Archetype Stack endpoint in The Numerology API: ranked archetype synthesis from core numerology numbers, request parameter options, authentication, multilingual JSON responses, numerology system support, and production-ready examples. Extended endpoints are available only on the direct Numerology API platform (RapidAPI gateway not supported).

Personal Archetype Stack¶

The Personal Archetype Stack endpoint produces a condensed, product-friendly ranked archetype stack from core numerology numbers. Use this page for integration-ready parameter rules, allowed options, and response examples.

Endpoint¶

Method	Path
`GET`	`https://api.numerologyapi.com/api/v1/personal-archetype-stack`
`POST`	`https://api.numerologyapi.com/api/v1/personal-archetype-stack`

Availability¶

Authentication: X-API-Key (or Authorization: Bearer YOUR_API_KEY)
Supported lang values: en, es, de, fr, pt, ar, hi, ja
Access channel: direct API (https://api.numerologyapi.com)
RapidAPI gateway: Not currently supported for extended endpoints
Optional numerology systems: pythagorean, chaldean, vedic (pythagorean is the default)

Parameters¶

GET Query Parameters¶

Parameter	Type	Required	Default	Options	Description
`full_name`	`string`	Yes	`—`	length `1..160`	Full name
`dob`	`string`	Yes	`—`	`YYYY-MM-DD`	Date of birth
`include_shadow`	`boolean`	No	`true`	`true`, `false`	Include shadow archetype in the response
`num_sys`	`string`	No	`pythagorean`	`pythagorean`, `chaldean`, `vedic`	Numerology system used for name calculations
`lang`	`string`	No	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Response language

POST Query Parameters¶

Parameter	Type	Required	Default	Options	Description
`lang`	`string`	No	`en`	`en`, `es`, `de`, `fr`, `pt`, `ar`, `hi`, `ja`	Response language

POST Body Parameters¶

Parameter	Type	Required	Default	Options	Description
`full_name`	`string`	Yes	`—`	length `1..160`	Full name
`dob`	`string`	Yes	`—`	`YYYY-MM-DD`	Date of birth
`include_shadow`	`boolean`	No	`true`	`true`, `false`	Include shadow archetype in the response
`num_sys`	`string`	No	`pythagorean`	`pythagorean`, `chaldean`, `vedic`	Numerology system used for name calculations

Request Examples¶

GET¶

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.numerologyapi.com/api/v1/personal-archetype-stack?full_name=Octavia%20Butler&dob=1947-06-22&include_shadow=true&num_sys=pythagorean&lang=en"

POST¶

curl -X POST "https://api.numerologyapi.com/api/v1/personal-archetype-stack?lang=en" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "full_name": "Octavia Butler",
  "dob": "1947-06-22",
  "include_shadow": true,
  "num_sys": "pythagorean"
}'

POST Body Example¶

{
  "full_name": "Octavia Butler",
  "dob": "1947-06-22",
  "include_shadow": true,
  "num_sys": "pythagorean"
}

Response Highlights¶

numbers
primary_archetype
secondary_archetype
shadow_archetype
archetype_stack
stack_labels
shadow_work_guidance

Response Example¶

{
  "numerology_system": "pythagorean",
  "full_name": "Octavia Butler",
  "numbers": {
    "life_path_number": 4,
    "expression_number": 7,
    "maturity_number": 11
  },
  "primary_archetype": {
    "archetype": "sage",
    "score": 44,
    "meaning": { "title": "The Sage", "overview": "..." }
  },
  "archetype_stack": []
}

Open Dashboard

Note

This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.