Skip to main content

Environments

Roja runs two hosted environments. Both speak the same API version and are documented by the same API reference.

EnvironmentBase URLPurpose
Productionhttps://api.getroja.comLive traffic. Real users, real money.
Staginghttps://api.roja.devIntegration testing. Safe to experiment against.

Staging and production are fully separate: accounts, tokens, tickets and loans never cross between them. A staging access token is rejected by production and vice versa.

Versioning

All routes are prefixed with /v1:

https://api.getroja.com/v1/tickets

Backwards-incompatible changes ship as a new version prefix. Additive changes — new endpoints, new optional fields, new enum values — can appear within /v1 at any time, so build clients that ignore fields they don't recognize.

Checking connectivity

GET /v1/meta/version is a public endpoint (no authentication) that returns the running API version — useful as a smoke test for your network setup:

curl https://api.getroja.com/v1/meta/version