Postman and Bruno

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

Postman

Option A: Fork from public workspace

1. Open the collection for the domain you need:

Or browse all collections in the RoxyAPI workspace.

2. Click Fork to copy the collection into your workspace
3. Set up your environment variables (see below)
4. Start making requests

Forking keeps your collection linked to ours. When we add new endpoints, you can pull updates without losing your changes.

Option B: Import from OpenAPI spec

If you prefer a standalone copy:

1. Open Postman and click Import
2. Select Link and paste any of the OpenAPI spec URLs below
3. Postman converts the spec into a ready-to-use collection

OpenAPI spec URLs

Set up your environment

Create a Postman environment so you only enter your API key once:

1. Click Environments in the sidebar
2. Click Create Environment and name it "RoxyAPI"
3. Add two variables:

4. In your collection, go to Authorization and set:
   • Type: API Key
   • Key: X-API-Key
   • Value: {{apiKey}}
   • Add to: Header

Every request in the collection inherits this auth. No need to set it per request.

Bruno

Bruno is an open source API client that stores collections as plain files. It imports from OpenAPI URLs directly.

1. Open Bruno
2. Click Import Collection
3. Select OpenAPI V3 Spec
4. Paste any of the OpenAPI spec URLs from the table above
5. Bruno generates a local collection with every endpoint ready to call

Set up auth in Bruno

1. Right-click the collection and select Settings
2. Under Auth, choose API Key
3. Set the key to X-API-Key and the value to your API key
4. All requests inherit this header

Bruno stores collections as .bru files on disk, so they work with Git version control. No cloud account needed.

What you can do

Once imported, every endpoint is pre-configured with the correct URL, method, parameters, and example payloads:

• Explore endpoints. Browse all available endpoints grouped by category. Each request includes parameter descriptions and example values.
• Test with live data. Hit Send and see real API responses. No code needed.
• Build request chains. Use Postman pre-request scripts or Bruno scripting to chain calls (e.g., get a birth chart, then run a compatibility check).
• Share with your team. Fork the Postman workspace or commit Bruno collections to your repo.
• Stay up to date. Forked Postman collections receive updates when we add new endpoints. Bruno users can re-import the OpenAPI URL to refresh.

FAQ

Which API 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, and Git-friendly collections. Both work equally well with RoxyAPI.

Do I need a Postman account?

You need a free Postman account to fork collections and use environments. Importing from an OpenAPI URL works without an account, but you lose the auto-update feature.

How do I test endpoints that require a request body?

POST endpoints like birth chart generation include example request bodies. In Postman, check the Body tab. In Bruno, check the Body section. Modify the values and hit Send.

Can I use other API clients?

Any tool that imports OpenAPI 3.0 specs works with RoxyAPI. This includes Insomnia, HTTPie, Thunder Client (VS Code), and REST Client (VS Code). Use the same OpenAPI spec URLs listed above.

Where do I get an API key?

Visit the pricing page to choose a plan, or check out the interactive API reference to test endpoints with a pre-filled test key first.