# Numerology Yearly Forecast API

The year ahead for a radical number 1 to 9, or for a birth date: how the year's universal number meets it, the year's theme, career, money, love and health, each month's planet and tone, the lucky and cautious months, colours and days.

- Endpoint: `POST https://api.96astroapi.com/v1/numerology/numerology-yearly-forecast`
- Family: [Numerology](https://96astroapi.com/apis/numerology.md)
- Input: Specific input
- Cost: 1 credit per successful call (sandbox keys are free)
- Status: available
- Delivery: Direct response
- Output languages: en
- Web page: https://96astroapi.com/apis/numerology/numerology-yearly-forecast

## Example request

```bash
curl https://api.96astroapi.com/v1/numerology/numerology-yearly-forecast \
  -H "Authorization: Bearer $ASTRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2027,"number":5}'
```

## Response

Every response is `{ "data": …, "meta": { "request_id", "credits_used", "warnings", "language" } }`.
The full request and response schema, with a captured example, is in the OpenAPI document: https://api.96astroapi.com/v1/openapi.json (path `/v1/numerology/numerology-yearly-forecast`).
