title: "Baby Name Forecast" description: Developer documentation for the Baby Name Forecast endpoint in The Numerology API: baby-name candidate comparison by expression, heart desire, personality, initials, expected birth date, and parent harmony, 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).

Baby Name Forecast¶

The Baby Name Forecast endpoint compares baby-name candidates and returns ranked name-fit insights. It supports optional expected birth date and parent-name harmony scoring. Use this page for integration-ready parameter rules, allowed options, and response examples.

Endpoint¶

Method	Path
`GET`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`
`POST`	`https://api.numerologyapi.com/api/v1/baby-name-forecast`

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
`candidate_names`	`array[string]`	Yes	`—`	repeat query parameter; max `8`	Candidate baby names
`expected_birth_date`	`string`	No	`null`	`YYYY-MM-DD`	Expected birth date
`parent_names`	`array[string]`	No	`[]`	repeat query parameter	Optional parent names
`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
`candidate_names`	`array[string]`	Yes	`—`	`1..8` items	Candidate baby names
`expected_birth_date`	`string \\| null`	No	`null`	`YYYY-MM-DD`	Expected birth date
`parent_names`	`array[string]`	No	`[]`	optional list	Optional parent names
`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/baby-name-forecast?candidate_names=Maya%20Rose%20Carter&candidate_names=Luna%20Elise%20Carter&expected_birth_date=2026-09-14&num_sys=pythagorean&lang=en"

POST¶

curl -X POST "https://api.numerologyapi.com/api/v1/baby-name-forecast?lang=en" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "candidate_names": ["Maya Rose Carter", "Luna Elise Carter"],
  "expected_birth_date": "2026-09-14",
  "parent_names": ["Nora Carter", "Eli Carter"],
  "num_sys": "pythagorean"
}'

POST Body Example¶

{
  "candidate_names": ["Maya Rose Carter", "Luna Elise Carter"],
  "expected_birth_date": "2026-09-14",
  "parent_names": ["Nora Carter", "Eli Carter"],
  "num_sys": "pythagorean"
}

Response Highlights¶

recommended_name
candidate_count
expected_life_path_number
candidates[].combined_fit_score
candidates[].ranking_label
candidates[].meaning
comparison_notes

Response Example¶

{
  "numerology_system": "pythagorean",
  "expected_birth_date": "2026-09-14",
  "expected_life_path_number": 6,
  "candidate_count": 2,
  "recommended_name": "Maya Rose Carter",
  "candidates": [
    {
      "candidate_name": "Maya Rose Carter",
      "expression_number": 3,
      "name_birth_harmony_score": 82,
      "combined_fit_score": 85,
      "ranking_label": "Strong Fit",
      "meaning": { "title": "The Expressive Child", "overview": "..." }
    }
  ]
}

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.