Quick Start

Six steps from nothing to a working API call.

1. Create an account

2. Select a plan

New accounts start on the free plan. See Pricing for current plans and quotas — upgrade any time from your dashboard.

3. Create an API key

From your dashboard's API Keys page, create a key and choose which scopes it needs (for example chart:read for birth charts). The secret is shown once, at creation — copy it immediately.

4. Authenticate

Send your key in the X-API-Key header on every request. See Authentication for details.

5. Make a request

curl -X POST https://api.astrologyservice.in/v1/chart \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"year":1990,"month":6,"day":15,"hour":10,"minute":30,"latitude":23.02,"longitude":72.57,"timezone":"Asia/Kolkata"}}'

const res = await fetch("https://api.astrologyservice.in/v1/chart", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    birth: {
      year: 1990, month: 6, day: 15,
      hour: 10, minute: 30,
      latitude: 23.02, longitude: 72.57,
      timezone: "Asia/Kolkata"
    }
  })
});
const chart = await res.json();

$response = Http::withHeaders([
    'X-API-Key' => 'YOUR_API_KEY',
])->post('https://api.astrologyservice.in/v1/chart', [
    'birth' => [
        'year' => 1990, 'month' => 6, 'day' => 15,
        'hour' => 10, 'minute' => 30,
        'latitude' => 23.02, 'longitude' => 72.57,
        'timezone' => 'Asia/Kolkata',
    ],
]);

6. Read the response

A successful request returns 200 OK with a JSON body. See Errors for what a failed request looks like, and the full API reference for the exact response schema of each endpoint.

Create Your Account