API Reference

The rockstar.ninja API is a JSON REST API. All authenticated endpoints require an Authorization: Bearer <jwt> header. Responses are JSON except for streaming endpoints which use NDJSON.

Base URL

https://rockstar.ninja/api/v1

Authentication

Include the JWT from rn account login in the Authorization header:

Authorization: Bearer eyJhbGciOi...

If the token expires, repeat the challenge/verify flow to get a new one.

Error format

All errors return JSON with an error field:

{
  "error": "human-readable error message"
}

Common status codes

Sections

• Endpoints — complete endpoint reference
• Streaming — how NDJSON streaming responses work
• Rate Limiting — rate limit tiers and behavior