Introduction to the Marigold API
Welcome to the Marigold Insights Developer Documentation. This wiki serves as the exhaustive, definitive guide to integrating your state's System of Record with our civic data anomaly detection engines.
The Architecture Philosophy
Voter integrity paradigms involve massive data tables containing millions of rows. Traditional API paradigms encourage developers to send these massive, raw JSON datasets over the wire to cloud processors. Marigold explicitly rejects this paradigm.
We operate on a Zero-Trust, Zero-PII architecture. Your monolithic infrastructure is the system of record. Marigold is the extremely optimized search and routing layer. At no point should raw Personally Identifiable Information (PII) such as unencrypted Social Security Numbers, exact dates of birth, or full names touch our cloud ingress points.
The Cryptographic Handshake
The Cryptographic Handshake
Instead of sending us raw citizen data, your server must implement AES-GCM (Galois/Counter Mode) authenticated encryption locally. You hash the dataset, encrypt the anomalous record IDs, and send us the resulting Ciphertext along with the Authentication Tag and Initialization Vector (Nonce).
When we receive this payload, we validate the cryptographic proof without ever reading the underlying identity string. We map the anomaly to a specific standard deviation cluster (Z-Score) and route the encrypted flag back to your system. You decrypt it locally. Our servers remain utterly blind to the identities involved.
Why Not Standard REST?
State agencies operate on legacy C#, Java, and Mainframe paradigms. Enforcing a standard REST architecture where we own the database creates immense compliance friction (SOC 2, FedRAMP, HIPAA, etc.). By offloading the storage completely to your system, we allow you to utilize our proprietary Fellegi-Sunter log-odds algorithms and standard deviation matrices without violating local data sovereignty laws.
Navigating This Wiki
This documentation is intentionally verbose. We have engineered this platform to scale to Series C volume and beyond, handling hundreds of millions of civic queries per hour. Please carefully read the following critical paths:
Authentication & Tokens
Learn how to issue Bearer tokens, rotate keys, and establish IP whitelisting for your institutional ingress.
Fellegi-Sunter Matching
Deep dive into the probabilistic mathematics behind our duplicate record isolation modules.
API Reference: Detect
Review the exact JSON schemas, required headers, and expected return codes for the primary analysis loop.
Error Dictionary
Debug cryptic cryptographic failures and Z-Score overflows with our canonical error definitions.