Postman and Bruno, test Roxy endpoints with no code

Q: Where do I get an API key?

The [pricing page](/pricing) or the [API reference](/api-reference) test key for prototyping.

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

Test every Roxy 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 10 Roxy 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 Roxy API key. Get one on the pricing page.
Postman or Bruno installed.

Step 1, import the spec

Every Roxy 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`
Tarot	`https://roxyapi.com/api/v2/tarot/openapi.json`
Numerology	`https://roxyapi.com/api/v2/numerology/openapi.json`
I Ching	`https://roxyapi.com/api/v2/iching/openapi.json`
Dreams	`https://roxyapi.com/api/v2/dreams/openapi.json`
Crystals	`https://roxyapi.com/api/v2/crystals/openapi.json`
Angel Numbers	`https://roxyapi.com/api/v2/angel-numbers/openapi.json`
Biorhythm	`https://roxyapi.com/api/v2/biorhythm/openapi.json`
Location	`https://roxyapi.com/api/v2/location/openapi.json`

Combined spec (all 10 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 Roxy 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

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

Postman

Click Environments in the sidebar.
Click Create Environment, name it "Roxy".
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=Mumbai (geocoding smoke test)

Gotchas

Auth header is X-API-Key, not Authorization: Bearer. Most API clients default to Bearer. Override it explicitly.
All paths live under /api/v2/. The spec URL is /api/v2/{domain}/openapi.json. Endpoint paths are /api/v2/{domain}/{endpoint}.
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 }. 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?

The pricing page or the API reference test key for prototyping.

What to build next

The API reference is a Scalar-rendered live playground with a pre-filled test key.
The SDK docs turn working curl calls into typed TypeScript, Python, or PHP code.
The MCP setup is the agent-first alternative. Wire Roxy into Claude Code, Cursor, or Antigravity and skip the request-crafting step.