API Reference

Compliance infrastructure endpoints across 10 categories.

Download OpenAPI Spec (JSON)Live API Spec

Base URL: https://api.overvoid.io

Onboarding

Create and manage entities (your counterparties).

POST/v1/onboarding/entitiesCreate a new entity
GET/v1/onboarding/entitiesList entities
GET/v1/onboarding/entities/{id}Get entity details
POST/v1/onboarding/entities/{id}/walletsAdd wallet to entity
GET/v1/onboarding/entities/{id}/walletsList entity wallets
GET/v1/onboarding/entities/{id}/compliance-checksList compliance check results
GET/v1/onboarding/entities/{id}/auditAudit log of compliance events
GET/v1/onboarding/entities/{id}/transfersTransfer history with screening results
GET/v1/onboarding/entities/{id}/alertsCompliance alerts with dispositions
GET/v1/onboarding/entities/{id}/compliance-reportDownload CSV compliance report
GET/v1/onboarding/entities/{id}/compliance-certificateDownload PDF compliance certificate
GET/v1/onboarding/entities/{id}/transfers/{tx_hash}/travel-ruleTravel rule data for a transfer

Compliance

Check compliance status and initiate compliant transfers.

GET/v1/compliance/entity/{id}/statusGet entity compliance status
GET/v1/compliance/wallet/{address}/statusGet wallet compliance status
POST/v1/compliance/batch-statusBatch status check
POST/v1/compliance/transfer/initiateInitiate compliant transfer (travel rule)
GET/v1/compliance/transfer/{id}Poll transfer status

Chain

On-chain queries — compliance status, sanctions, transactions.

GET/v1/chain/compliance/{address}Get on-chain compliance flags
GET/v1/chain/sanctioned/{address}Check sanctions oracle
GET/v1/chain/tx/{hash}Get transaction status

Webhooks

Register endpoints to receive real-time event notifications.

POST/v1/developer/webhook-endpointsRegister webhook endpoint
GET/v1/developer/webhook-endpointsList webhook endpoints
DELETE/v1/developer/webhook-endpoints/{id}Delete webhook endpoint
GET/v1/developer/webhook-endpoints/{id}/deliveriesList deliveries
POST/v1/developer/webhook-deliveries/{id}/retryRetry failed delivery

Data Ingestion

Submit transactions, fiat events, and screening results via API — no chain indexer or built-in screening required.

POST/v1/monitoring/transfersIngest single transaction (on-chain or off-chain)
POST/v1/monitoring/transfers/batchBatch ingest up to 1000 transactions
POST/v1/monitoring/fiat-eventsIngest fiat event (wire/ACH/card/check)
POST/v1/monitoring/screeningSubmit external screening result

Transaction Monitoring

Real-time surveillance engine with 50 rules (crypto, fiat, card, check), alert management, and dispositions.

GET/v1/onboarding/entities/{id}/alertsList alerts (severity, status filters)
GET/v1/onboarding/entities/{id}/alerts/{alert_id}Get alert detail
POST/v1/onboarding/entities/{id}/alerts/{alert_id}/dispositionSet alert disposition
GET/v1/onboarding/entities/{id}/alerts/{alert_id}/ai-triageAI triage recommendation

Case Management

Investigation workflow from alert escalation through SAR determination.

GET/v1/onboarding/entities/{id}/casesList cases
GET/v1/onboarding/entities/{id}/cases/{case_id}Get case detail
POST/v1/onboarding/entities/{id}/cases/{case_id}/assignAssign investigator
POST/v1/onboarding/entities/{id}/cases/{case_id}/statusTransition case status
POST/v1/onboarding/entities/{id}/cases/{case_id}/commentAdd investigation note

SAR & CTR Filing

Generate, validate, and file SARs and CTRs via FinCEN BSA E-Filing Schema 2.0.

GET/v1/onboarding/entities/{id}/cases/{case_id}/sar-draftPre-filled SAR data from case evidence
POST/v1/onboarding/entities/{id}/cases/{case_id}/sar-xmlGenerate FinCEN SAR XML
POST/v1/onboarding/entities/{id}/cases/{case_id}/sar-validateValidate SAR XML (moov-io/fincen)
POST/v1/onboarding/entities/{id}/cases/{case_id}/file-sarMark SAR as filed
GET/v1/onboarding/entities/{id}/sar-historySAR filing history
GET/v1/onboarding/entities/{id}/ctr-draft/{alert_id}Pre-filled CTR data
POST/v1/onboarding/entities/{id}/ctr-xmlGenerate FinCEN CTR XML
POST/v1/onboarding/entities/{id}/ctr-validateValidate CTR XML
POST/v1/onboarding/entities/{id}/file-ctrMark CTR as filed
GET/v1/onboarding/entities/{id}/ctr-historyCTR filing history

Screening & Risk

Sanctions screening, PEP detection, adverse media, and dynamic risk scoring.

GET/v1/onboarding/entities/{id}/adverse-mediaAdverse media results
POST/v1/onboarding/entities/{id}/adverse-media/refreshTrigger adverse media re-check
GET/v1/onboarding/entities/{id}/risk-historyRisk score trend over time

FinCEN 314(a/b)

Mandatory and voluntary information sharing under USA PATRIOT Act.

POST/v1/monitoring/314a/uploadUpload 314(a) CSV file
GET/v1/monitoring/314a/filesList uploaded 314(a) files
GET/v1/monitoring/314a/files/{file_id}/matchesGet matches for a 314(a) file
POST/v1/monitoring/314a/matches/{match_id}/reviewReview 314(a) match
POST/v1/monitoring/314b/partnersRegister 314(b) partner institution
GET/v1/monitoring/314b/partnersList 314(b) partners
PUT/v1/monitoring/314b/partners/{partner_id}/verifyVerify partner certification
POST/v1/monitoring/314b/requestsCreate info sharing request
GET/v1/monitoring/314b/requestsList info sharing requests
POST/v1/monitoring/314b/requests/{request_id}/respondRespond to info sharing request

AI Compliance

AI-powered investigation summaries, SAR narratives, alert triage, and risk explanations.

GET/v1/onboarding/entities/{id}/cases/{case_id}/ai-summaryAI investigation summary
POST/v1/onboarding/entities/{id}/cases/{case_id}/ai-sar-narrativeAI-drafted SAR narrative
GET/v1/onboarding/entities/{id}/alerts/{alert_id}/ai-triageAI alert triage recommendation
GET/v1/onboarding/entities/{id}/ai-risk-explanationAI risk score explanation

All endpoints require authentication via Authorization: Bearer cusd_test_YOUR_KEY. See the Authentication guide for details.