API Reference

Complete reference for all RAIL API endpoints

https://api.responsibleailabs.ai

Authentication

All API requests (except /health) require authentication using your API key in the Authorization header:

Authorization: Bearer YOUR_RAIL_API_KEY

GET/health

Check API availability (no authentication required)

POST/verify

Verify API key validity and check plan tier

Score and analyze content across 8 RAIL dimensions.

POST/railscore/v1/score/basic

Fast response with essential scoring information only

POST/railscore/v1/score/detailed

Detailed insights with issues, explanations, and AI-generated reprompt

POST/railscore/v1/score/basic/dimension

Fast evaluation of a single specific dimension

POST/railscore/v1/score/detailed/dimension

Detailed analysis of a single specific dimension with explanations and issues

POST/railscore/v1/score/basic/custom

Fast evaluation with user-selected dimensions and custom percentage-based weights

POST/railscore/v1/score/detailed/custom

Detailed analysis with user-selected dimensions and custom weights

Generate improvement prompts for AI-generated content.

POST/railscore/v1/reprompt/basic

Evaluate AI-generated content and provide improvement prompt if below threshold

POST/railscore/v1/reprompt/detailed

Detailed evaluation and comprehensive improvement prompt with specific issues per dimension

Code	Meaning
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - API key inactive or suspended
`422`	Unprocessable Entity - Validation error
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error