Name: Government Revenue Dependency Score API — Federal Contract Revenue Exposure for Public Companies
Brand: hvcapis
SKU: api-hvcapis-grds
Availability: InStock
Author: API Market

HVCAPIs

# Government Revenue Dependency Score API

Score any U.S. public company's federal contract revenue exposure in a
single API call — sourced directly from SEC EDGAR, USASpending.gov, and
SAM.gov. No data vendors, no scraping, no manual parsing of government
procurement systems.

---

## What You Get in One Call

- **0–100 dependency score** — what percentage of revenue comes from
  federal contracts
- **Agency breakdown** — which government agencies are the biggest
  customers and their share of contract revenue
- **3-year trend** — is government exposure growing, stable, or shrinking
- **Compliance flags** — active debarments, agency concentration risk,
  and SAM.gov registration status
- **Subsidiary detection** — identifies separately registered entities
  for large multi-facility contractors

---

## Live Results — June 2026

Real scores computed from official U.S. government data.

| Ticker | Company | Score | Dependency | Govt Revenue |
|---|---|---|---|---|
| RTX | RTX Corp (Raytheon) | 61 / High | 67.26% | $54.3B of $80.7B |
| LDOS | Leidos Holdings | 54 / Moderate | 69.41% | $11.9B of $17.2B |
| NOC | Northrop Grumman | 50 / Moderate | 45.83% | $19.2B of $42.0B |
| BAH | Booz Allen Hamilton | 50 / Moderate | 47.97% | $5.4B of $11.2B |
| GD | General Dynamics | 43 / Moderate | 36.30% | $19.1B of $52.6B |
| LMT | Lockheed Martin | 41 / Moderate | 36.86% | $27.7B of $75.0B |
| CACI | CACI International | 30 / Low | 35.31% | $3.0B of $8.6B |
| SAIC | Science Applications Intl | 18 / Minimal | 15.70% | $1.1B of $7.3B |
| MSFT | Microsoft | 5 / Minimal | 0.74% | $2.1B of $281.7B |
| WMT | Walmart | 16 / Minimal | 0.0% | No federal contracts |
| AAPL | Apple | 0 / Minimal | 0.0% | <$1M of $416.2B |

---

## Score Interpretation

| Score | Label | Meaning |
|---|---|---|
| 0–20 | Minimal | Negligible government exposure |
| 21–40 | Low | Small but measurable contract revenue |
| 41–60 | Moderate | Government is a meaningful revenue source |
| 61–80 | High | Significant concentration risk |
| 81–100 | Extreme | Majority of revenue from federal contracts |

---

## Example Response

```json
{
  "ticker": "LDOS",
  "company": "Leidos Holdings, Inc.",
  "score": 54,
  "score_label": "Moderate dependency",
  "dependency_pct": 69.41,
  "total_revenue_usd": 17174000000,
  "govt_contract_revenue_usd": 11920505759,
  "fiscal_year": 2025,
  "trend": "stable",
  "trend_pct_change": -0.65,
  "top_agencies": [
    {
      "name": "Department of Defense",
      "awards_ttm_usd": 8832534290,
      "pct_of_govt_total": 74.1,
      "contract_count": 312
    },
    {
      "name": "Department of Health and Human Services",
      "awards_ttm_usd": 1428460483,
      "pct_of_govt_total": 12.0,
      "contract_count": 87
    }
  ],
  "risk_flags": [
    {
      "code": "SINGLE_AGENCY_OVER_50PCT",
      "severity": "medium",
      "message": "Department of Defense accounts for 74.1% of government contract revenue."
    },
    {
      "code": "TOP3_AGENCIES_OVER_90PCT",
      "severity": "medium",
      "message": "The top 3 agencies account for 95.7% of government revenue - highly concentrated."
    },
    {
      "code": "MULTI_ENTITY_CONTRACTOR",
      "severity": "low",
      "message": "This company has 82 separately registered SAM entities. The dependency score reflects the primary contracting entity - total government exposure may be higher."
    }
  ],
  "debarment_active": false,
  "sam_registered": true,
  "subsidiary_count": 82,
  "cache_hit": false,
  "response_ms": 51,
  "data_as_of": "2026-06-24"
}
```

---

## Endpoints

### `GET /score/{ticker}`

Full dependency score for any publicly traded U.S. company.

| Parameter | Type | Description |
|---|---|---|
| `ticker` | string | Exchange ticker (e.g. `LMT`, `LDOS`, `RTX`) |
| `fiscal_year` | integer | Optional — defaults to most recent |
| `refresh` | boolean | Bypass cache — **Ultra tier only** |

### `POST /score/batch`

Score multiple tickers in one request.

```json
{ "tickers": ["LMT", "NOC", "GD", "LDOS", "RTX", "BAH"] }
```

| Plan | Batch limit |
|---|---|
| Basic | 1 |
| Pro | 10 |
| Ultra | 50 |
| Mega | 200 |

### `GET /company/{ticker}` *(Ultra)*

Cross-source entity identifiers — CIK, UEI, CAGE code, subsidiaries.

### `GET /contracts/{ticker}` *(Ultra)*

Paginated individual contract awards from USASpending.gov and FPDS.

### `GET /health`

Live status of all upstream data sources. No API key required.

### `GET /example`

Static example response for integration testing. No API key required.

---

## Risk Flags

| Code | Severity | Fires when |
|---|---|---|
| `DEBARMENT_ACTIVE` | critical | Active SAM.gov exclusion |
| `SUBSIDIARY_DEBARMENT` | high | Subsidiary has active exclusion |
| `EXTREME_DEPENDENCY` | high | Score ≥ 81 |
| `SINGLE_AGENCY_OVER_75PCT` | high | One agency > 75% of govt revenue |
| `HIGH_DEPENDENCY` | medium | Score ≥ 61 |
| `SINGLE_AGENCY_OVER_50PCT` | medium | One agency > 50% of govt revenue |
| `TOP3_AGENCIES_OVER_90PCT` | medium | Top 3 agencies > 90% of govt revenue |
| `RAPID_INCREASE` | medium | Awards up > 10% year-over-year |
| `RAPID_DECREASE` | medium | Awards down > 10% year-over-year |
| `CONSECUTIVE_INCREASE` | medium | 3 consecutive years of increase |
| `DEBARMENT_RECENT` | medium | Exclusion lifted within 24 months |
| `ENTITY_MATCH_LOW_CONFIDENCE` | low | No SAM.gov registration found |
| `CUSTOMER_DISCLOSURE_MISSING` | low | No govt disclosure in 10-K |
| `MULTI_ENTITY_CONTRACTOR` | low | Multiple SAM registrations |
| `FISCAL_YEAR_MISMATCH` | low | Non-calendar fiscal year |

---

## Data Sources

All sources are official U.S. government APIs. Updated daily.

| Source | Data provided |
|---|---|
| **SEC EDGAR** | Annual revenue, customer concentration disclosures |
| **USASpending.gov** | Federal contract award totals by agency |
| **FPDS** | Contract action codes — new awards vs modifications |
| **SAM.gov** | Entity registration, debarment, exclusion records |

---

## Verified Primary Entity Coverage

For large government contractors with many SAM registrations, a verified
lookup table ensures the highest-volume primary entity is always selected:

| Ticker | Captured | Actual Govt % |
|---|---|---|
| RTX | ~67% | ~60% |
| LDOS | ~69% | ~80% |
| NOC | ~46% | ~85% |
| BAH | ~48% | ~97% |
| GD | ~36% | ~75% |
| LMT | ~37% | ~71% |
| CACI | ~35% | ~95% |
| SAIC | ~16% | ~90% |

The `MULTI_ENTITY_CONTRACTOR` flag and `subsidiary_count` field indicate
when single-entity capture understates total exposure.

---

## Pricing

| Plan | Price | Requests/month | Batch |
|---|---|---|---|
| Basic | Free | 50 | 1 |
| Pro | $29/mo | 1,000 | 10 |
| Ultra | $99/mo | 10,000 | 50 |
| Mega | $299/mo | 100,000 | 200 |

Ultra and Mega plans include force cache refresh, the `/company` and
`/contracts` endpoints, and SLA uptime guarantees.

---

## Performance

Results are cached for 24 hours. Warm cache responses return in
**50–100ms**. Cold cache requests (first call for a ticker) typically
return in 8–20 seconds as data is fetched live from government sources.

---

## Coverage

- All U.S. publicly traded companies with SEC EDGAR filings
- Federal prime contract awards FY2007 to present
- U.S. federal government only (not state or local)
- Private companies cannot be scored (no public revenue data)

---

## Who Uses This

**Equity analysts** — screen portfolios for government revenue
concentration risk ahead of budget cycles and earnings seasons.

**Hedge funds** — identify companies whose revenue is sensitive to
continuing resolutions, sequestration, or agency budget cuts.

**M&A due diligence** — assess government revenue concentration in
acquisition targets before valuation.

**ESG researchers** — quantify federal contractor exposure as a
governance and regulatory risk metric.

**Fintech developers** — embed structured government exposure data into
financial platforms without building the data pipeline yourself.

---

## Support

Response within 24 hours on business days. Include the `X-Request-ID`
response header and ticker symbol in all support requests.

Check `GET /health` for real-time upstream source status.


Score any U.S. public company's dependence on federal government contracts. Returns a 0–100 dependency score, agency concentration breakdown, 3-year trend, and compliance risk flags — sourced from SEC EDGAR, USASpending.gov, and SAM.gov. Built for equity analysts, hedge funds, and ESG researchers.

Government Revenue Dependency Score API — Federal Contract Revenue Exposure for Public Companies

Basic

Ultra

Mega

Score any U.S. public company's federal contract exposure. 0–100 dependency score, agency breakdown, and compliance flags from SEC EDGAR and USASpending.gov.