Astrology API Postman and Bruno collections

Q: Where do I get an API key?

[Get your API key](/account?tab=keys). Every plan includes every domain, and the key is live the moment checkout completes.

Import a RoxyAPI OpenAPI spec, set one header, hit Send. Time to ship: 2 minutes.

Test every RoxyAPI endpoint without writing code. Import our OpenAPI specs into Postman or Bruno and make live API calls in under a minute.

What you can build with this

Interactive API exploration across all 18 RoxyAPI domains
Request chains (geocode a city, then post the chart with the result)
Pre-configured collections teammates can fork and reuse
Local-first, Git-friendly API workspaces via Bruno
Quick-and-dirty endpoint testing before wiring a feature in code

What you need, 30 seconds

A RoxyAPI key. Get your API key.
Postman or Bruno installed.

Step 1, import the spec

Every RoxyAPI domain has a live OpenAPI spec you can point any API client at.

OpenAPI spec URLs

Domain	URL
Western Astrology	`https://roxyapi.com/api/v2/astrology/openapi.json`
Vedic Astrology	`https://roxyapi.com/api/v2/vedic-astrology/openapi.json`
Forecast	`https://roxyapi.com/api/v2/forecast/openapi.json`
Human Design	`https://roxyapi.com/api/v2/human-design/openapi.json`
Chinese Astrology	`https://roxyapi.com/api/v2/chinese-astrology/openapi.json`
Feng Shui	`https://roxyapi.com/api/v2/feng-shui/openapi.json`
Numerology	`https://roxyapi.com/api/v2/numerology/openapi.json`
Tarot	`https://roxyapi.com/api/v2/tarot/openapi.json`
Biorhythm	`https://roxyapi.com/api/v2/biorhythm/openapi.json`
I Ching	`https://roxyapi.com/api/v2/iching/openapi.json`
Crystals	`https://roxyapi.com/api/v2/crystals/openapi.json`
Dreams	`https://roxyapi.com/api/v2/dreams/openapi.json`
Angel Numbers	`https://roxyapi.com/api/v2/angel-numbers/openapi.json`
Location	`https://roxyapi.com/api/v2/location/openapi.json`

Combined spec (all 18+ domains at once): https://roxyapi.com/api/v2/openapi.json.

Postman

Option A, fork from the public workspace.

Collection	Postman link
Western Astrology	Open in Postman
Vedic Astrology	Open in Postman
Tarot	Open in Postman
Numerology	Open in Postman
I Ching	Open in Postman
Dreams	Open in Postman
Crystals	Open in Postman
Angel Numbers	Open in Postman
Location	Open in Postman

Or browse the full RoxyAPI Postman workspace. Click Fork to copy a collection into your workspace. Forked collections pull updates when we add new endpoints.

Option B, import from OpenAPI.

Open Postman and click Import.
Select Link and paste any spec URL from the table above.
Postman converts the spec into a ready-to-use collection.

Bruno

Bruno is an open-source API client that stores collections as plain files. Git-friendly.

Open Bruno and click Import Collection.
Select OpenAPI V3 Spec.
Paste any spec URL from the table above.
Bruno generates a local collection with every endpoint ready to call.

Step 2, set the auth header

RoxyAPI uses X-API-Key, not Authorization: Bearer.

Postman

Click Environments in the sidebar.
Click Create Environment, name it "RoxyAPI".
Add two variables:

Variable	Value	Type
`baseUrl`	`https://roxyapi.com`	default
`apiKey`	your API key	secret

Select the collection > Authorization tab. Set:
- Type: API Key
- Key: X-API-Key
- Value: {{apiKey}}
- Add to: Header

Every request in the collection inherits this auth.

Bruno

Right-click the collection > Settings.
Under Auth, choose API Key.
Set Key to X-API-Key, Value to your API key.

All requests inherit the header.

Do not share your environment file. The apiKey variable contains your secret key. Postman marks it as secret, but always verify before exporting. Bruno .bru files are plain text. If you commit them, use an env variable or .gitignore the secrets file.

Step 3, hit Send

Pick any endpoint from the imported collection. POST endpoints ship with example request bodies. Modify values, hit Send, see real API responses.

Starter endpoints to try first:

GET /astrology/horoscope/aries/daily (zero body)
POST /numerology/life-path body: {"year":1990,"month":7,"day":15}
POST /tarot/daily body: {} (empty body is valid)
GET /location/search?q=London (geocoding smoke test)

Gotchas

Auth header is X-API-Key, not Authorization: Bearer. Most API clients default to Bearer. Override it explicitly.
The base URL arrives complete. A domain spec declares its full server, https://roxyapi.com/api/v2/{domain}, and its paths hang off that, so the collection variable your client creates on import is ready to send.
POST endpoints always send JSON. Content-Type: application/json. Empty body is OK for seed-optional endpoints (daily tarot, daily hexagram).
Timezone accepts IANA strings or decimals on chart endpoints. Prefer "America/New_York".
Error shape is { error, code, doc_url }. No { success: false } wrapper. If you see 401, check the header name and the key.

FAQ

Which client should I use?

Postman if you want cloud sync, team sharing, and auto-updates from our public workspace. Bruno if you prefer open source, local-first, Git-friendly collections. Both work equally well.

Do I need a Postman account?

A free account is needed to fork collections and use environments. Importing from an OpenAPI URL works without an account, but you lose auto-updates.

Can I use Insomnia, HTTPie, Thunder Client, REST Client?

Any tool that imports OpenAPI 3.0 works. Use the same spec URLs above.

Where do I get an API key?

Get your API key. Every plan includes every domain, and the key is live the moment checkout completes.

What to build next

The API reference is a Scalar-rendered live playground. Paste your key to test any endpoint.
The SDK docs turn working curl calls into typed TypeScript, Python, PHP, C#, or Go code.
The MCP setup is the agent-first alternative. Point a coding agent like Claude Code, Cursor, or Copilot at the keyless docs server and it crafts the request for you, no manual building. Runtime agents on ChatGPT, Claude Desktop, Gemini, or n8n use the per-domain servers for live calls.