Single UEI

Returns every red-flag signal the public federal record contains about one vendor UEI, plus a mechanical triage verdict so compliance teams can sort without parsing the full tree. Seven signals, all derived from SAM data: exclusion status, address cluster, name-variant cluster, individual exclusions at the same address, coordinated-wave membership, last-award-to-exclusion gap, and dual-CAGE detection.

Parameters

uei (path) - 12-character SAM UEI. Case-insensitive; non-alphanumeric input returns 422.

Response

{
  "response_version": "1",
  "uei": "N2EDPB1SMN55",
  "entity_name": "Bella Mia Donna LLC",
  "address": {"line1": "111 SW 1 ST", "city": "Pompano Beach", "state": "FL"},
  "address_source": "exclusions",
  "computed_at": "2026-04-24T16:22:10Z",
  "triage": {
    "category": "high",
    "label": "High risk",
    "reasons": [
      "entity is currently on the federal exclusion list: Ineligible (Proceedings Pending) by DLA (create_date 2025-11-21)",
      "debarred alongside 24 entities by the same agency on 2025-11-21 (coordinated enforcement wave)"
    ]
  },
  "signals": {
    "exclusion_status":                 { "excluded": true, "exclusion_type": "Ineligible (Proceedings Pending)", "excluding_agency_code": "DLA", "create_date": "2025-11-21", "_more_keys": "see API reference for full shape" },
    "address_cluster":                  { "total_at_address": 24, "excluded_at_address": 24, "address_type": "normal", "others": [{"uei": "...", "entity_name": "...", "create_date": "2025-11-21"}] },
    "name_variant_cluster":             { "match_count": 1, "excluded_match_count": 1, "variants": [] },
    "individual_exclusions_at_address": { "count": 5, "individuals": [{"name": "...", "create_date": "2025-11-21"}] },
    "wave_membership":                  { "in_coordinated_wave": true, "wave_date": "2025-11-21", "wave_size": 24, "wave_members": [{"uei": "...", "entity_name": "..."}] },
    "timing_gap":                       { "last_sam_award_date": "2025-11-17", "exclusion_create_date": "2025-11-21", "days_between": 4 },
    "dual_cage":                        { "has_dual_cage": false, "cage_codes": ["8SGL5"] }
  },
  "subaward_exposure": {
    "as_prime": { "total_paid_to_subs": 0, "distinct_sub_vendors": 0, "subaward_count": 0,
                  "first_subaward_date": null, "last_subaward_date": null, "top_subs": [] },
    "as_sub":   { "total_received_from_primes": 482000.00, "distinct_primes": 3,
                  "subaward_count": 7, "first_subaward_date": "2024-06-04",
                  "last_subaward_date": "2025-11-17",
                  "top_primes": [{"uei": "H11HD5VHGHN3", "name": "LOCKHEED MARTIN CORP",
                                   "total": 320000.00, "subaward_count": 4}] },
    "window_days": 1825
  },
  "disclaimers": ["All signals derive from the public federal record."]
}

Triage categories

high - the entity itself is actively excluded.
elevated - not excluded, but ≥2 co-tenants at the same address are excluded, or a name-variant entity is excluded, or ≥1 individual exclusion shares the address.
needs_review - weaker signals only (e.g. multiple CAGE codes).
clean - no signals returned.
unknown - UEI not present in SAM exclusions or opportunities data at all.

Triage rules are deliberately simple and visible in triage.reasons so your compliance team can override by reading the signals themselves. Keys in the response are stable: values may be null, empty arrays, or false, but the shape never changes. Safe to parse with response_version branching if you need to stay compatible as we add signals.

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/vendor-risk/N2EDPB1SMN55"

Notes: Returns 404 only when the UEI has no record in any of our SAM tables (exclusions, opportunities, or the ~885K-firm entity registry). SAM-registered vendors with no exclusion and no recent award still return 200 with a clean triage verdict. For non-US addresses where the state field is empty (Singapore, Hong Kong, Ankara, etc.), clustering falls back to line1+city. The address_source field tells you which table the address came from: exclusions, opportunities, entities, or unknown when no address was found. See /vendor-risk-api for signal definitions, the triage rules, and worked examples from real federal enforcement actions.

Enrichment blocks (Pro)

Two top-level blocks sit alongside signals and triage (NOT nested inside them) on Pro responses. Both are descriptive, they don't change the triage verdict, but compliance teams read them alongside the seven signals to size the supply-chain footprint around a single UEI.

subaward_exposure block: FFATA subaward dollar flow on both sides:

as_prime: what this UEI has paid out to sub-vendors: {total_paid_to_subs, distinct_sub_vendors, subaward_count, first_subaward_date, last_subaward_date, top_subs: [{uei, name, total, subaward_count}, ... up to 5]}.
as_sub: what this UEI has received from primes: {total_received_from_primes, distinct_primes, subaward_count, first_subaward_date, last_subaward_date, top_primes: [{uei, name, total, subaward_count}, ... up to 5]}.
window_days: the lookback (1825 today).

Both sub-blocks always populate (zero shape when no records); subaward_exposure itself is omitted only when this UEI has no record in any of our tables (i.e. when the whole response would be a 404 candidate).

contract_exposure block: FPDS prime contract activity (parallel to subaward_exposure):

fpds_obligated_total, fpds_distinct_contracts, fpds_transaction_count: magnitudes.
fpds_first_action_date, fpds_latest_action_date: activity bounds in the window.
top_agencies: array of up to 5 {name, value, transaction_count} objects, awarding sub-agencies ranked by total $.
window_days: the lookback (1825 today).

The block returns the zero shape when this UEI has no FPDS prime contract activity in the window.

Worked example (Pro response, actively excluded UEI with mixed compliance picture)

UEI C1ZLDAS18FJ3 (ATI Government Solutions) was placed on the SBA "Ineligible (Proceedings Pending)" list on 2025-10-21 alongside its 3 named principals, debarred as individuals the same day (a firm-plus-officers coordinated action; wave_size 4). The contract_exposure block surfaces activity from 2024-10-01 onward (FY2025+): $95.26M in net obligations across 33 contracts, with the IRS as the largest awarding sub-agency at $82.55M. The subaward_exposure.as_prime shows this UEI paid out $55.44M to 10 distinct sub-vendors over the same window. For the recency-focused "is the problem ongoing?" view, see the parallel example on /exclusions/{uei_sam}, where the last-365-days window shows -$9.31M net (deobligations exceeding new obligations recently). Triage scores on the seven signals above; the exposure blocks add descriptive supply-chain context.

{
  "uei": "C1ZLDAS18FJ3",
  "entity_name": "ATI Government Solutions",
  "signals": { "..." },
  "triage": {
    "category": "high",
    "label": "High risk",
    "reasons": [
      "entity is currently on the federal exclusion list: Ineligible (Proceedings Pending) by SBA (create_date 2025-10-21)",
      "debarred alongside 4 entities by the same agency on 2025-10-21 (coordinated enforcement wave)"
    ]
  },
  "subaward_exposure": {
    "as_prime": {
      "total_paid_to_subs": 55440463.08,
      "distinct_sub_vendors": 10,
      "subaward_count": 16,
      "first_subaward_date": "2024-10-01",
      "last_subaward_date": "2025-10-22",
      "top_subs": [
        {"uei": "W6G5J8F8ETH7", "name": "VIBRANTECH SOLUTIONS INC.",
         "total": 13591324.20, "subaward_count": 5},
        {"uei": "NHPJUKUF8WL9", "name": "BASECAMP CONSULTING AND SOLUTIONS LLC",
         "total": 13049945.55, "subaward_count": 1},
        "...up to 5 entries"
      ]
    },
    "as_sub": {
      "total_received_from_primes": 0.0,
      "distinct_primes": 0,
      "subaward_count": 0,
      "first_subaward_date": null,
      "last_subaward_date": null,
      "top_primes": []
    },
    "window_days": 1825
  },
  "contract_exposure": {
    "fpds_obligated_total": 95259892.19,
    "fpds_distinct_contracts": 33,
    "fpds_transaction_count": 122,
    "fpds_first_action_date": "2024-10-23",
    "fpds_latest_action_date": "2026-05-18",
    "top_agencies": [
      {"name": "Internal Revenue Service",
       "value": 82545810.72, "transaction_count": 67},
      {"name": "Office of the Assistant Secretary for Administration and Management",
       "value": 5863769.27, "transaction_count": 13},
      "...up to 5 entries"
    ],
    "window_days": 1825
  },
  "_sources": ["derived_vendor_risk", "sam_exclusions", "sam_entities", "sam_opportunities", "usaspending_ffata", "usaspending_fpds"]
}

Field shapes for both blocks are also documented at the top of the Endpoints section under Pro enrichment fields (universal pattern). Live response verified 2026-06-01.