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.
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 live playground. Paste your key to test any endpoint.
The SDK docs turn working curl calls into typed TypeScript, Python, PHP, C#, Go, Rust, and Dart 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.
R
RosieYour AI guide to RoxyAPI
R
Hi, I am Rosie, your guide to the RoxyAPI insight tools.
Ask me to read your birth chart, pull a card, or map your numbers, and I will interpret what it means for you. Unlike most AIs, I never make the numbers up: every reading runs on real, verified calculations. Curious about the API, pricing, or docs instead? Ask me that too.