# Tong Shu date selection

`POST https://api.astroway.info/v1/chinese/tong-shu/select`

Walk a date range and return the days the almanac endorses for one activity, each with the officer that decided it. Optionally drop the days that clash a person's animal. Range capped at 366 days and a longer one is refused, not truncated.

Group: Chinese: Zodiac & Feng Shui. Auth: `X-Api-Key` header. Operation ID: `chinese_tong-shu_select`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `undefined` |  | no | object |  |
| `undefined` |  | no | object |  |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `from` | string | yes |  |
| `to` | string | yes |  |
| `activity` | "marriage" \| "opening" \| "moving" \| "travel" \| "contract" \| "construction" \| "demolition" \| "medical" \| … | yes |  |
| `avoidClashWith` | string | no |  |
| `includeNeutral` | boolean | no |  |
| `language` | string | no |  |

```json
{
  "from": "2026-09-01",
  "to": "2026-12-31",
  "activity": "marriage",
  "avoidClashWith": "Rat"
}
```

## Responses

| Status | Meaning |
|---|---|
| 200 | Successful calculation |
| 400 | Validation error |
| 401 | Missing or invalid API key |

### Success fields, under `data`

| Field | Type | Required | Description |
|---|---|---|---|
| `activity` | string | no |  |
| `scanned` | number | no |  |
| `matched` | number | no |  |
| `dropped` | object | no |  |
| `dropped.byRegister` | number | no |  |
| `dropped.byClash` | number | no |  |
| `days` | object[] | no |  |

## Example

```bash
curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-09-01", "to": "2026-12-31", "activity": "marriage", "avoidClashWith": "Rat" }'
```

---

Rendered from https://api.astroway.info/v1/openapi.json. HTML page: https://api.astroway.info/docs/api/operations/chinese_tong-shu_select/