Developer API Documentation

Integrate Revtect.ai with your existing hospital systems

REST API Access

Secure, plan-restricted API endpoints for system integration

Authentication

Two authentication methods are supported:

  • 1. JWT Tokens: For web dashboard access
  • 2. API Keys: For system-to-system integration

API keys are generated by hospital administrators and can be scoped with expiration dates.

Plan Restrictions

API endpoints are restricted based on your hospital's subscription plan:

  • ✓ Starter: Admission & OPD endpoints only
  • ✓ Standard: Adds Laboratory endpoints
  • ✓ Premium: Full access including Pharmacy
  • ✓ Enterprise: All endpoints + custom integrations

API Endpoints

Complete REST API for data ingestion and anomaly management

Data Ingestion

POST /api/v1/dashboard/ingest-data

Upload patient and billing data for anomaly detection

Auth: JWT Token or API Key | Plan: All plans

Anomaly Management

GET /api/v1/dashboard/anomalies

Retrieve detected anomalies with filtering and pagination

Auth: JWT Token or API Key | Plan: All plans

GET /api/v1/dashboard/patient/{patient_id}

Get anomalies for a specific patient

Auth: JWT Token or API Key | Plan: All plans

POST /api/v1/dashboard/anomalies/{anomaly_id}/resolve

Mark an anomaly as resolved

Auth: JWT Token or API Key | Plan: All plans

Dashboard Overview

GET /api/v1/dashboard/overview

Get summary statistics and department breakdown

Auth: JWT Token or API Key | Plan: All plans

API Key Management

Generate and manage API keys for system integration

Generating API Keys

Hospital administrators can generate API keys from the dashboard:

  1. Login to your dashboard
  2. Navigate to Settings → API Keys
  3. Click "Generate New API Key"
  4. Provide a name and expiration date
  5. Copy and securely store the generated key

Important: API keys are only shown once upon generation. Store them securely.

Using API Keys

Include your API key in the request header:

X-API-Key: your_api_key_here

API keys work alongside JWT tokens. If both are provided, API key authentication takes precedence.

Interactive API Documentation

Explore all endpoints with Swagger/OpenAPI documentation

Interactive API Documentation

Access interactive API documentation with live endpoint testing

View API Documentation Open Swagger UI

Complete integration guide available at /website/api-docs.html

Integration Use Cases

Common integration scenarios for hospital systems

Real-Time Data Sync

Automatically send patient and billing data as transactions occur in your HIS/EMR system for continuous anomaly detection.

Batch Processing

Upload daily or weekly data exports from your billing system for comprehensive revenue leakage analysis.

Anomaly Notifications

Poll the anomalies endpoint to retrieve new anomalies and display them in your existing workflow systems.

Ready to Integrate?

Start by registering your hospital and generating your first API key

Get Started View API Docs