# Prokerala Astrology API

> REST API for Vedic and Western astrology: horoscopes, panchang, kundli, marriage matching, numerology, KP astrology, muhurat, and PDF reports. OAuth 2.0 client-credentials authentication; JSON responses (SVG for charts, PDF for reports).

The API is built by Prokerala.com, in operation since 2005 and one of the oldest astrology websites on the web, covering Vedic, Western, and Chinese astrology as well as numerology. Its astrology section serves millions of users every month, and the API is powered by the same calculation engine and domain expertise as the consumer site — the accuracy that traffic depends on is what the API exposes.

The base URL for all endpoints is https://api.prokerala.com/v2 and tokens are issued at https://api.prokerala.com/token. Free sandbox (Test) apps are available for development and CI — no credits are consumed, with restricted input values. The API intentionally sends no CORS headers — call it from a backend, not from browser JavaScript.

## API Reference

- [OpenAPI 3 specification](https://api.prokerala.com/spec/astrology.v2.yaml): complete endpoint, parameter, and schema reference (YAML)
- [API documentation](https://api.prokerala.com/docs): browsable HTML reference
- [Getting started](https://api.prokerala.com/getting-started): first-request walkthrough

## Guides

- [Authentication](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/authentication.md): OAuth client-credentials flow, token caching, JWT claims
- [Error handling](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/error-handling.md): error envelope, status codes, retries, rate limits, credits
- [Sandbox (Test) mode](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/sandbox.md): free Test apps and their input restrictions
- [Query parameters](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/query-parameters.md): encoding rules, object parameters, booleans, datetime offsets
- [Examples](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/examples.md): copy-paste cURL and Node.js examples
- [Common pitfalls](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/common-pitfalls.md): frequent integration mistakes and troubleshooting
- [SDKs and examples](https://raw.githubusercontent.com/prokerala/agent-skills/main/prokerala-astrology-api/references/sdks-and-examples.md): official SDKs (PHP and more), example clients, browser/mobile proxy patterns

## Agent Skills

- [Agent skills index](https://api.prokerala.com/.well-known/agent-skills/index.json): digest-verified skill archives per the Agent Skills Discovery RFC
- [Skills repository](https://github.com/prokerala/agent-skills): source for the Prokerala agent skills

## Optional

- [Pricing](https://api.prokerala.com/pricing): subscription plans
- [API credits](https://api.prokerala.com/api-credits): per-endpoint credit costs
- [PDF reports](https://api.prokerala.com/pdf-reports): available report types