Spiritual Intelligence API

Documentation

Everything you need to get started. Create an API key, authenticate, send your first request.

Quick Start

1

Get your API key

Sign up on the API page for a free beta key.

2

Authentication

Send your key as a Bearer token in the Authorization header:

Authorization: Bearer spk_live_your_key_here
3

Make your first request

curl https://api.rene-koch.com/api/v1/collective-astrology/forecast/now \
  -H "Authorization: Bearer spk_live_your_key"
4

Or use the Python SDK

from spiritual_api import SpiritualAPI

api = SpiritualAPI("spk_live_your_key")
forecast = api.collective.forecast_now()
print(forecast["sun"]["sign"])

Error Handling

All errors follow a consistent format:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit of 10 requests/minute exceeded",
    "request_id": "a1b2c3d4-...",
    "plan": "free"
  }
}
401

Invalid or missing API key

403

Endpoint requires higher plan

429

Rate limit exceeded (check Retry-After header)

422

Validation error in request data

Endpoint Reference

Full interactive documentation with Try-It-Out: OpenAPI/Swagger UI

Collective Astrology

Free

Real-time cosmic data without person reference

GET /api/v1/collective-astrology/forecast/now
POST /api/v1/collective-astrology/aspects
POST /api/v1/collective-astrology/moon-phase/current
GET /api/v1/collective-astrology/portal-days
GET /api/v1/collective-astrology/retrograde

Collective Extended

Free

Extended collective features

GET /api/v1/collective-extended/dreamspell
GET /api/v1/collective-extended/energy-quality
POST /api/v1/collective-extended/planetary-hours
GET /api/v1/collective-extended/tong-shu
GET /api/v1/collective-extended/sabbats

Astrology

Pro

Birth charts, transits, progressions

POST /api/v1/astrology/calculate/{person_uuid}
GET /api/v1/astrology/summary/{person_uuid}
GET /api/v1/astrology/transits/{person_uuid}/now
GET /api/v1/astrology/transits/{person_uuid}/week

Human Design

Pro

Complete HD chart calculation

POST /api/v1/hd/calculate/{person_uuid}
GET /api/v1/hd/{person_uuid}/complete
GET /api/v1/hd/{person_uuid}/gates
GET /api/v1/hd/{person_uuid}/channels

Numerology

Pro

Numerological calculations

POST /api/v1/numerology/calculate/{person_uuid}
POST /api/v1/numerology/name-analysis
POST /api/v1/numerology/timing/find-optimal-dates

More Systems

Pro

Gene Keys, BaZi, Enneagram, Feng Shui and more

GET /api/v1/gene-keys/{person_uuid}
GET /api/v1/bazi/{person_uuid}
POST /api/v1/enneagram/calculate
POST /api/v1/feng-shui/kua-number
GET /api/v1/dreamspell/{person_uuid}
GET /api/v1/destiny-cards/{person_uuid}

Ready to get started?

Request your free beta API key and start building in 2 minutes.

Get started