Skip to main content

Postman Collection

Every Asterwise endpoint is available as a pre-configured Postman request. Use the collection to explore the API interactively before integrating it into code.

Download​

asterwise-api.postman_collection.json

The file includes:

  • Every public endpoint (131 requests), one folder per API area: Astrology, Advanced, KP, Lal Kitab, Prashna, Western Astrology, Western, Horoscope, Numerology, Tarot, Crystals, Dreams and Utilities
  • Example request bodies and saved example responses taken from the API reference pages
  • Two collection variables: base_url (set to https://api.asterwise.com) and api_key (empty until you fill it in)
  • An Authorization: Bearer {{api_key}} header on every request

Import​

Postman desktop​

  1. Open Postman
  2. Click Import (top-left)
  3. Drag the downloaded asterwise-api.postman_collection.json onto the import panel — or click Files and select it
  4. The collection appears in your sidebar as "Asterwise API"

Postman web​

  1. Visit postman.com and sign in
  2. From the workspace sidebar, click Import
  3. Select the downloaded JSON file
  4. Pick a workspace and confirm

Add your API key​

Once imported:

  1. Click the Asterwise API collection in the sidebar
  2. Open the Variables tab
  3. Paste your API key (starts with aw_) into the Current value of api_key
  4. Save

Every request reads the key from that variable, so you set it once. Keep it in Current value: that stays on your machine, while Initial value is shared if you export or share the collection.

Make your first request​

  1. Expand the collection
  2. Open Astrology > Natal Chart
  3. Click Send

You should see a Vedic natal chart for the example birth data in the request body.

Other environments​

To call a different API (for example a local development server), change the base_url collection variable. Every request URL starts with {{base_url}}.

Updates​

The collection is generated from the live OpenAPI spec, and the docs build fails if the published file falls out of date. When new endpoints ship, download and import the file again to pick them up.

Programmatic access​

If you'd rather generate clients in your own language, see the OpenAPI page — the same source of truth that produces this Postman collection also produces SDK-ready OpenAPI specs.