Incumbent History — a federal contractor's contract lineage

Who holds the work, and how much of it? Look up a federal contractor — by its UEI or by name — and get its contract history rolled up per awarding agency and NAICS: how many contracts, total obligated dollars, the fiscal-year span, and the latest period-of-performance end date. With a full citation receipt.

Built for capture teams sizing up an incumbent before a recompete, and for AI agents doing competitive research on federal contractors, with the exact public source attached to every number.

Data comes straight from USASpending.gov — the primary, public-domain federal record of contract awards. No aggregator, no scoring, no editorializing.

What you can ask

• What is Lockheed Martin's contract history — by agency and NAICS — and how much has it been obligated?
• For UEI ABC123DEF456, which agencies buy from it, in which NAICS, and how many contracts?
• Narrow an incumbent's lineage to a single agency or NAICS.

Keywords: incumbent, federal contractor, contract history, competitor research, capture management, UEI, NAICS, awarding agency, obligated dollars, GovCon, business development, government contracts, contractor profile, USAspending, market share, past performance footprint.

Input

Provide either a uei or a recipient name prefix (at least one is required).

Field	Type	Required	Notes
uei	string	one of these	Exact federal awardee UEI.
recipient	string	one of these	Recipient name prefix.
agency	string	no	Awarding-agency name prefix.
naics	string	no	NAICS code or 2–6 digit prefix.
limit	integer 1–500	no (default 50)	Max rows.

{ "recipient": "Lockheed", "limit": 25 }

Output — an answer with a receipt

The actor returns one receipt object (also stored as the run's OUTPUT). The answer is the lineage rows; matches declares the exact cross-source joins, and citations is the exact source you can re-run yourself.

{
  "answer": [
    {
      "recipient_uei": "G4KDGE4JFFK7",
      "recipient_name": "LOCKHEED MARTIN CORPORATION",
      "awarding_agency": "Department of Defense",
      "awarding_agency_code": "097",
      "naics_code": "336411",
      "naics_description": "AIRCRAFT MANUFACTURING",
      "contract_count": 59,
      "total_cents": 1804299333899300,
      "first_fiscal_year": 2007,
      "last_fiscal_year": 2027,
      "latest_pop_end_date": "2027-04-30"
    }
  ],
  "matches": [
    {
      "match_method": "exact",
      "left_key": "usaspending.recipient_uei",
      "right_key": "citature.entity_recipient.uei"
    },
    {
      "match_method": "exact",
      "left_key": "usaspending.awarding_agency_code",
      "right_key": "citature.entity_agency_code.agency_code"
    }
  ],
  "coverage": [
    "Coverage reflects records currently in citature's dataset, not the full upstream history.",
    "Recompete timing reflects each contract's current period-of-performance end date as reported to the awarding agency; option years and modifications can push the actual recompete later."
  ],
  "guardrails": [
    "Research over public-domain federal records — not legal, financial, or eligibility advice.",
    "citature reports what the record says. It never renders a compliance verdict, a screening pass/fail, or a recommendation.",
    "Entity-level records only (committees, candidates, recipients, agencies, contracts). No individual-person data."
  ],
  "schema_version": "0.1.0"
}

Money is always integer cents (total_cents). The contractor is resolved on the UEI and the agency on its official toptier code — both exact joins, declared in matches.

Guardrails

• Research over public-domain federal records — not legal, financial, or eligibility advice.
• citature reports what the record says. It never renders a determination, a ranking of vendors, or a recommendation.
• Entity-level records only. No individual-person data is ever returned.

Pricing

Pay per successful answer. You are charged only when an answer is served; a rejected or failed request is never billed.