Compliance Reporting

Transfer history, screening results, alerts, audit trails, and downloadable reports for your auditors.

Overview

Every transaction processed through the compliance platform is screened before execution. These endpoints let you retrieve the full compliance trail for any entity: transfer history with per-transaction screening results, compliance alerts with disposition outcomes, audit logs, and downloadable reports for auditors.

Transfer History

Returns all on-chain transfers involving your entity's wallets, with per-transaction compliance screening results and travel rule status.

curl https://api.overvoid.io/v1/onboarding/entities/{entity_id}/transfers \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"

Query parameters:

Param	Type	Description
`chain_id`	int	Filter by chain (11155111, 421614, 84532)
`from_date`	ISO 8601	Start of date range
`to_date`	ISO 8601	End of date range
`limit`	int	Max results (default 20, max 100)
`offset`	int	Pagination offset

Each transfer includes:

Field	Description
`screening_result`	`PASS`, `REVIEW`, or `null` (not yet screened). REVIEW means an open compliance alert exists on the wallet.
`travel_rule_status`	`pending`, `submitted`, `acknowledged`, or `null` (below threshold)
`monitored`	Whether the transfer has been processed by the transaction monitoring engine

Travel Rule Detail

For transfers that required travel rule compliance, retrieve the full originator/beneficiary data:

curl https://api.overvoid.io/v1/onboarding/entities/{entity_id}/transfers/{tx_hash}/travel-rule \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"

Returns originator and beneficiary entity names, wallet addresses, the applicable threshold (US $3,000 or EU €0), and the travel rule submission status. Only available if your entity is the originator or beneficiary of the transfer.

Compliance Alerts

View alerts generated by the transaction monitoring engine for your entity. Each alert includes the disposition outcome from the Overvoid compliance team.

curl https://api.overvoid.io/v1/onboarding/entities/{entity_id}/alerts \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"

Filter by severity (low, medium, high, critical) or status (open, investigating, resolved, escalated).

Resolved alerts include disposition data:

Field	Description
`disposition_result`	`true_positive`, `false_positive`, or `inconclusive`
`disposition_reason`	Analyst notes explaining the resolution (e.g., "Legitimate payroll disbursement")
`disposition_date`	ISO 8601 timestamp of the disposition

Audit Log

Complete timeline of all compliance events for your entity: check completions, approvals, status changes, wallet registrations, and rescreenings.

curl https://api.overvoid.io/v1/onboarding/entities/{entity_id}/audit \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"

Compliance Checks

Individual screening results from each compliance provider (Middesk for KYB, SumSub for UBO, Chainalysis for AML/sanctions).

curl "https://api.overvoid.io/v1/onboarding/entities/{entity_id}/compliance-checks?check_type=SANCTIONS" \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"

Filter by check_type (KYB, UBO, AML, SANCTIONS) and paginate with limit/offset.

Download Compliance Report (CSV)

Export a complete compliance report as CSV for your auditors. Includes compliance checks, audit log, transfer history with screening results, and alerts with dispositions.

curl -o compliance-report.csv \
  "https://api.overvoid.io/v1/onboarding/entities/{entity_id}/compliance-report?from_date=2026-01-01T00:00:00Z&to_date=2026-03-31T23:59:59Z" \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"

Use from_date and to_date (ISO 8601) to scope the report. Omit both to get the full history.

Download Compliance Certificate (PDF)

Generate a PDF compliance certificate showing your entity's current compliance status, risk tier, screening flags, authorized wallets, and a unique certificate ID. Hand this to your auditor as a point-in-time attestation.

curl -o compliance-certificate.pdf \
  https://api.overvoid.io/v1/onboarding/entities/{entity_id}/compliance-certificate \
  -H "Authorization: Bearer cusd_test_YOUR_KEY"