API Reference

Base URL: https://api.safeurl.ai

Interactive docs (Scalar UI) are available at /openapi.

Authentication

All /v1 endpoints require an API key. Pass it in the Authorization header:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

API keys are created in the dashboard with one or more scopes:

Rate limiting

100 requests per minute per IP address on all /v1 routes. Exceeding the limit returns 429 Too Many Requests.

Credits

Your credit balance and usage history are available in the dashboard. Each completed scan consumes one credit. The credits API is not exposed to API key holders.

Errors

All errors follow a consistent shape:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits to create scan"
  }
}