API

REST API for fraud-intelligence integration

Pull lead detail, sector aggregates, and watermarked dossiers into your case-management system, BI tool, or analyst workflow. Per-lead model — no bulk extraction surface.

Authentication

Bearer token in Authorization header. Tokens are scoped to the subscriber account and tier; we rotate compromised keys within hours of detection. Token issuance and rotation via in-app account settings.

Base URL

https://api.sentinelgraph.com/v1/
HTTPS only. TLS 1.2+. Versioned via path; v1 is the current stable.

Rate limits

Quotas calibrated to legitimate analyst workflows — not bulk extraction. Returned in X-RateLimit-Remaining. 429 on quota exceeded; subscriber notified at 80%.

Endpoints

Per-lead, per-sector, per-graph

GET/api/v1/leads/{lead_id}
Pro+200/day · Pro · 500/day · Enterprise · 1,000/day · Custom

Per-lead detail

Returns the full evidence chain for a single lead — score, tier, signals, source-cited observations, resolution confidence. The same data the in-app lead view shows.

GET/api/v1/leads/{lead_id}/dossier
Pro+Tier-capped

Watermarked dossier (PDF)

Generates a per-lead, subscriber-traceable PDF dossier. Watermarked with subscriber identity + report ID + timestamp. Counts against monthly dossier cap (Pro 50/mo · Enterprise 500/mo · Custom 10,000/mo).

GET/api/v1/leads/{lead_id}/graph
Pro+200 lookups/day baseline

Graph neighborhood

Returns the connected entity graph around a lead — registered-agent webs, address clusters, officer overlaps, family/business networks. Configurable depth (1-3 hops) and edge-type filter.

GET/api/v1/sectors/{sector}
Pro+500 calls/day baseline

Sector overview

Aggregated counts and dollar exposure for a sector (healthcare, disaster, workers_comp, housing, snap, sba_fraud, unemployment, cross_sector). Supports state-level breakdown and time-series.

GET/api/v1/sectors/{sector}/cross-flow
Enterprise+500 calls/day baseline

Cross-sector flows

Returns sector-pair entity counts — which entities span multiple fraud sectors. Useful for identifying multi-program fraud patterns.

GET/api/v1/search
Pro+500 searches/day · Enterprise+ · 2,000/day · Custom

Search by name, identifier, or location

Free-text search returning lead summaries (id, name, score, tier, sector, state). Limited to 50 results per query.

By design

What the API does not — and will not — offer

The shape of the API enforces the same protection model as the in-app product. These limits are explicit, documented, and not negotiable per request.

Bulk export (CSV / XLSX / JSON)

Sentinel does not offer bulk export at any tier. Every record is requested per-lead, attributable, watermarked, and rate-limited. This is by design — protects subjects from indiscriminate harvesting and protects subscribers from data-resale liability claims.

Streaming / batch endpoints

No `?limit=10000` or pagination beyond the per-call result cap. Search returns max 50 leads; sector overviews return aggregated counts, not individual records.

Webhook firehose of all new leads

Per-lead webhook events (new lead matched watchlist, status change) are available at Custom tier — but only for leads in the subscriber's saved filters or watchlists. No untargeted firehose.

Admin / cross-tenant endpoints

No subscriber can query data scoped to another subscriber. No internal admin endpoints exposed.

Sample response

Lead detail shape

GET /api/v1/leads/3157566b-28cb-444c-85a3-48791590f38c
{
  "lead_id": "3157566b-28cb-444c-85a3-48791590f38c",
  "tier": "platinum",
  "score": 87,
  "sector": "healthcare",
  "canonical_name": "[REDACTED]",
  "state": "CA",
  "signals": {
    "exclusion_linkage": { "weight": "high", "source": "OIG-LEIE", "confidence": 0.94 },
    "registered_agent_web": { "cluster_size": 8, "weight": "high" },
    "address_cluster": { "shared_with": 4, "address_type": "residential" },
    "enforcement_adjacency": null
  },
  "evidence_chain": [
    { "source": "OIG-LEIE", "record_id": "...", "accessed": "2026-04-29", "match_type": "exact_npi" },
    { "source": "CA SOS", "record_id": "...", "accessed": "2026-04-29", "match_type": "officer_name" }
  ],
  "lead_status": "new_lead",
  "case_classification": null,
  "created_at": "2026-04-12T14:22:11Z",
  "_links": {
    "graph": "/api/v1/leads/3157566b.../graph",
    "dossier": "/api/v1/leads/3157566b.../dossier"
  }
}

Field set is illustrative; the production schema is documented in the OpenAPI spec available to active subscribers. Each evidence item links back to a specific public-record citation. case_classification is null for new leads; populated for proven cases that appear in the reference catalog.

Need an API integration assessment?

If you're considering wiring SentinelGraph into a case management system, fraud detection pipeline, or BI dashboard, we'll do a no-cost feasibility briefing — including a sample integration with your tooling.

Request a Briefing

Important disclaimer: SentinelGraph provides structured intelligence based on publicly available data. It does not provide legal advice, conduct investigations, or make determinations of fraud, liability, or regulatory violation. All findings are preliminary, evidence-traceable observations intended to support — not replace — qualified legal, investigative, or compliance review. Use of this service does not create an attorney-client relationship or any professional engagement unless separately agreed in writing.