Introduction

The API is a resource-oriented REST interface. All requests go over HTTPS, bodies and responses are JSON, and every request is signed with an API key.

Getting started in four steps

1. Create an account Create your API customer account in the API panel at www.astrowise.io/api-panel.
2. Generate an API key After choosing a plan or an endpoint package, generate your key in the panel and store it somewhere safe.
3. Send your first request Verify your connection with the /ping endpoint, which costs no credits.
4. Go to production Pick the plan or endpoint package that fits your needs and review your rate limits.

Example request

Paid endpoints are called with POST and expect birth data in the body. Time zones must be given in IANA format.

curl -X POST https://www.astrowise.io/api/v1/chart/natal \
  -H "Authorization: Bearer ab_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-04-12",
    "time": "08:35",
    "lat": 41.0082,
    "lng": 28.9784,
    "timezone": "Europe/Istanbul"
  }'

Example response

Successful responses contain success, data and meta fields. The meta block reports the request id (request_id), the credits charged, and your remaining credits/quota.

{
  "success": true,
  "data": {
    "chart_type": "natal",
    "chart_key": "natal",
    "title": "Doğum Haritası (Natal)",
    "png_data_uri": "data:image/png;base64,iVBORw0KGgo..."
  },
  "meta": { "request_id": "5a1f2b3c-...", "credits_charged": 1, "credits_remaining": 97, "quota_remaining": 1000 }
}

Note: drawable charts like chart.natal do not return raw astrology data (planets/houses/aspects) — they return a PNG watermarked with "www.astrobilge.com" in the bottom-right corner. The png_data_uri field can be used directly in an <img src>.

This is abbreviated — see the full real response on the Endpoint Reference page →