API Reference

Base URL: https://api.korastratum.com/api/v1

All endpoints require Authorization and X-Tenant-ID headers. See Authentication.

Endpoints

Screening

Method	Path	Description
POST	/v1/screenings	Create a screening (sync or async)
GET	/v1/screenings	List screenings
GET	/v1/screenings/{screening_id}	Get screening result
POST	/v1/screenings/batch	Create batch screening
GET	/v1/screenings/batch/{batch_id}	Get batch screening status
POST	/v1/screenings/reschedule	Schedule a rescreen (Coming Soon)

Subjects

Method	Path	Description
POST	/v1/subjects	Create a subject
GET	/v1/subjects	List subjects
GET	/v1/subjects/{subject_id}	Get subject details
PATCH	/v1/subjects/{subject_id}	Update a subject
GET	/v1/subjects/{subject_id}/screenings	Get subject's screenings
GET	/v1/subjects/{subject_id}/risk	Get subject's risk profile
POST	/v1/subjects/{subject_id}/relationships	Add a relationship
GET	/v1/subjects/{subject_id}/relationships	List relationships

Case Management

Method	Path	Description
POST	/v1/cases	Create a case
GET	/v1/cases	List cases
GET	/v1/cases/{case_id}	Get case details
PUT	/v1/cases/{case_id}/assign	Assign a case
PUT	/v1/cases/{case_id}/escalate	Escalate a case
POST	/v1/cases/{case_id}/activities	Add case event
GET	/v1/cases/{case_id}/activities	List case events
POST	/v1/cases/{case_id}/attachments	Add attachment
GET	/v1/cases/{case_id}/attachments	List attachments
PUT	/v1/cases/{case_id}/disposition	Set case disposition
POST	/v1/cases/{case_id}/override	Record decision override

Transaction Monitoring

Method	Path	Description
POST	/v1/monitoring/evaluate	Evaluate a transaction
GET	/v1/monitoring/alerts	List alerts
GET	/v1/monitoring/alerts/{alert_id}	Get alert details
PUT	/v1/monitoring/alerts/{alert_id}/disposition	Dispose an alert
GET	/v1/monitoring/rules	List monitoring rules
POST	/v1/monitoring/rules	Create a monitoring rule
PUT	/v1/monitoring/rules/{rule_id}	Update a rule
DELETE	/v1/monitoring/rules/{rule_id}	Delete a rule

Datasets

Method	Path	Description
GET	/v1/datasets	List datasets
GET	/v1/datasets/{source}	Get dataset details
GET	/v1/datasets/{source}/versions	List dataset versions
POST	/v1/datasets/{source}/ingest	Trigger data ingestion
GET	/v1/datasets/entries	Search entries

Rules & Configuration

Method	Path	Description
GET	/v1/rulesets	List rulesets
POST	/v1/rulesets	Create a ruleset
GET	/v1/rulesets/{ruleset_id}	Get ruleset
GET	/v1/rulesets/{ruleset_id}/versions	List ruleset versions
POST	/v1/rulesets/{ruleset_id}/versions	Create ruleset version
PUT	/v1/rulesets/{ruleset_id}/versions/{version_id}/activate	Activate version
GET	/v1/risk-factors	Get risk factors
PUT	/v1/risk-factors	Update risk factors
GET	/v1/risk-bands	Get risk bands
PUT	/v1/risk-bands	Update risk bands

Reporting

Method	Path	Description
POST	/v1/reports/regulatory	Generate regulatory report
GET	/v1/reports/regulatory	List regulatory reports
GET	/v1/reports/regulatory/{report_id}	Get report
PUT	/v1/reports/regulatory/{report_id}/submit	Submit report
GET	/v1/reports/screening-summary	Get screening summary
GET	/v1/reports/case-summary	Get case summary

Webhooks

Method	Path	Description
POST	/v1/webhooks/subscriptions	Create subscription
GET	/v1/webhooks/subscriptions	List subscriptions
GET	/v1/webhooks/subscriptions/{subscription_id}	Get subscription
PUT	/v1/webhooks/subscriptions/{subscription_id}	Update subscription
DELETE	/v1/webhooks/subscriptions/{subscription_id}	Delete subscription
POST	/v1/webhooks/subscriptions/{subscription_id}/test	Send test event
GET	/v1/webhooks/deliveries	List deliveries
POST	/v1/webhooks/deliveries/{delivery_id}/retry	Retry delivery

Audit

Method	Path	Description
GET	/v1/audit/logs	Query audit logs
POST	/v1/audit/export	Export audit trail
GET	/v1/audit/export/{export_id}	Get export status

Health

Method	Path	Description
GET	/health	Health check
GET	/ready	Readiness check