---
title: "Create Free Chart Run"
method: POST
path: "/api/free-chart-runs"
---

# Create Free Chart Run

`POST /api/free-chart-runs`

## Request

- Base URL: `https://yuanzizhiyi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://yuanzizhiyi.com/api/free-chart-runs`
- Auth: none declared

## Request body

- FreeChartRunRequest
  - `runId` string, required
  - `visitorId` string, required
  - `sessionId` string, required
  - `channel` string, nullable
  - `landingContext` object
  - `gender` string
  - `entryMode` string, required
  - `calendarType` string, required
  - `birthYear` union
    - string
    - integer
  - `birthRegion` string, nullable
  - `timeCorrectionMode` string
  - `internal` boolean
  - `locale` 'zh-CN' | 'zh-Hant' | 'en'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yuanzizhiyi/apis/yuanzi-zhiyi.md) · [All operations](https://skmtc.dev/yuanzizhiyi/apis/yuanzi-zhiyi/llms.txt) · [OpenAPI document](https://skmtc.dev/yuanzizhiyi/apis/yuanzi-zhiyi/revisions/d063fae7ac16?raw)