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 is approximately 53 KB and includes:

  • Every public endpoint (115 endpoints across all categories)
  • Pre-configured request bodies with realistic example values
  • Authentication scaffolding ready for your API key
  • Environment template with the production base URL

Import​

Postman desktop​

  1. Open Postman
  2. Click Import (top-left)
  3. Drag the downloaded asterwise-api.json onto the import panel — or click Files and select it
  4. The collection appears in your sidebar under "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

Set up authentication​

Once imported:

  1. Right-click the Asterwise API collection in the sidebar
  2. Select Edit
  3. Open the Authorization tab
  4. Set Type to Bearer Token
  5. Set Token to your API key (starts with aw_)
  6. Save

Every request in the collection now uses your key.

Make your first request​

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

You should see a successful response with a Vedic natal chart computed for the default example birth data.

Environment variables​

The collection ships with a single environment variable, BASE_URL, set to https://api.asterwise.com. To switch to a different environment (e.g. a local development API), edit the environment and change BASE_URL to your endpoint.

You can also add a API_KEY environment variable and reference it as {{API_KEY}} in the Authorization header — useful when sharing the collection with teammates without exposing your key.

Update cadence​

The Postman collection is regenerated from the live OpenAPI spec on every API deploy. When new endpoints ship, re-import the file to pick them up. The collection's structure mirrors the API reference navigation, so finding a specific endpoint is consistent across Postman and the docs.

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.