---
title: "The solar return chart for a year, cast for the birth place or another location."
method: POST
path: "/v1/solar-return"
tags: ["API Pro"]
---

# The solar return chart for a year, cast for the birth place or another location.

`POST /v1/solar-return`

## Request

- Base URL: `https://api.natalchart.ai`
- URL: `https://api.natalchart.ai/v1/solar-return`
- Auth: HTTP bearer

## Request body

- object
  - `birth` Birth, required
    - `date` string, date, required: Birth date, YYYY-MM-DD, 1800 to 2399.
    - `time` string, nullable: Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.
    - `latitude` number, required
    - `longitude` number, required
    - `timezone` string: IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.
  - `year` integer, required
  - `location` object
    - `latitude` number
    - `longitude` number

## Response `200`

The calculation, as JSON.

- object

## Other responses

- `400`: An error, always in this shape.
- `401`: An error, always in this shape.
- `403`: An error, always in this shape.
- `429`: An error, always in this shape.

---

[API](https://skmtc.dev/natalchart/apis/natalchart-ai-api.md) · [All operations](https://skmtc.dev/natalchart/apis/natalchart-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/natalchart/apis/natalchart-ai-api/revisions/e7032175f336?raw)