Profile

Combined SAM registration + award profile for one UEI. Returns 200 if either the SAM entity registry or our award data has the UEI; returns 404 only when both miss. Award fields populate when the UEI has at least one Award Notice; otherwise they zero out and the registration / entity blocks still populate.

Parameters

• uei (path) - 12-character SAM Unique Entity Identifier. Normalized: lowercase, mixed case, and surrounding whitespace are accepted.

Response

{
  "uei": "XX2WFHJEFB45",
  "name": "KAMPI COMPONENTS CO INC",
  "primary_city": "FAIRLESS HILLS",
  "primary_state": "PA",
  "total_awards": 842,
  "total_value": 223500000.0,
  "avg_value": 265440.0,
  "first_award_date": "2024-11-04",
  "last_award_date": "2026-04-18",
  "awards_last_90d": 47,
  "awards_last_12mo": 312,
  "top_naics": [
    {"naics": "332710", "awards": 198, "value": 52400000.0}
  ],
  "top_agencies": [
    {"agency": "DEPT OF DEFENSE", "awards": 601, "value": 168200000.0}
  ],
  "top_agency_share_pct": 100.0,
  "set_aside_distribution": [
    {"set_aside": "UNRESTRICTED", "awards": 830, "value": 218000000.0, "pct_of_awards": 98.6},
    {"set_aside": "SBA",          "awards": 6,   "value": 4500000.0,   "pct_of_awards": 0.7},
    {"set_aside": "NONE",         "awards": 6,   "value": 13000000.0,  "pct_of_awards": 0.7}
  ],
  "registration": {
    "status": "A",
    "active": true,
    "registration_date": "2001-08-16",
    "activation_date": "2026-01-21",
    "expiration_date": "2027-01-19",
    "expiring_soon": false,
    "source_extract_date": "2026-04-05"
  },
  "entity": {
    "legal_business_name": "KAMPI COMPONENTS CO INC",
    "dba_name": null,
    "entity_structure_code": "2L",
    "entity_url": "www.kampi.com",
    "physical_address": {
      "street1": "...", "city": "FAIRLESS HILLS",
      "state": "PA", "zip": "19030", "country": "USA"
    },
    "primary_naics": "423990",
    "naics_codes": ["423990Y", "332710Y", "..."],
    "psc_codes": ["...", "..."],
    "business_types": ["2X", "XS"],
    "business_types_labels": [
      "For Profit Organization",
      "Subchapter S Corporation"
    ],
    "cage_codes": ["7Z016"]
  }
}

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/companies/XX2WFHJEFB45"

Use cases: compliance check (registration.active + registration.expiration_date), customer-concentration risk (fpds_top_agency_share_pct for the comprehensive signal across the full FPDS record; the award-notice-based top_agency_share_pct can overstate concentration for diversified vendors), set-aside mix (set_aside_distribution: what % of their wins are SDVOSB / WOSB / 8(a)), pipeline health (awards_last_90d vs awards_last_12mo), capability mapping (top_naics, entity.business_types_labels). UEI normalization: lowercase, mixed case, and surrounding whitespace are accepted.

For SAM-data-only lookups without the award merge, see /api/v1/entities/{uei} (any plan).

Subaward revenue fields

The profile carries three subaward fields alongside the prime-award totals (within current subaward coverage, FY2025 + FY2026 today). They surface the "true federal revenue" picture that prime-only data misses, for SMBs in particular, sub revenue is often the larger half:

• sub_revenue_total: total dollars this UEI has received as a sub-vendor (sum of subaward_amount).
• top_paying_primes: up to 10 primes that have paid this UEI as a sub, sorted by total $. Each entry: {uei, name, total, subaward_count}.
• prime_revenue_share: float in [0, 1], the share of this UEI's combined federal revenue that came in as prime contracts (vs subs). Computed as fpds_obligated_total / (fpds_obligated_total + sub_revenue_total), using the FPDS prime obligation total (not the SAM-noticed total_value, which undercounts prime work and would read near 0 for FPDS-active firms). null when neither prime nor sub revenue exists; a pure-prime vendor reads 1.0.

Fields are populated for every UEI we have profile data on; sub_revenue_total and top_paying_primes zero out when no subawards exist (prime_revenue_share then reads 1.0 if the UEI has FPDS prime activity, and is null only when it has neither prime nor sub revenue). For the underlying records, use /api/v1/companies/{uei}/prime-relationships.

FPDS prime contract activity fields

The profile also carries FPDS prime contract aggregates from the federal procurement system of record. These cover the recipient's full direct prime contract activity (every base award and modification under their UEI in the plan window), where the SAM Award Notice total_value field above covers only the SAM-noticed slice (~10-30% of obligations). Both views are surfaced so callers can pick the denominator that matches their question.

• fpds_obligated_total: total federal_action_obligation obligated to this UEI as a prime, summed across every FPDS transaction in the FY2025-onward window (since 2024-10-01).
• fpds_distinct_contracts: count of distinct contracts (contract_award_unique_key) the recipient holds.
• fpds_transaction_count: count of every FPDS row: base awards plus every modification.
• fpds_first_action_date / fpds_latest_action_date: ISO date bounds on the recipient's FPDS activity in the window.
• fpds_top_naics: array of up to 5 {code, description, transaction_count, value} objects, top NAICS by total $. Each object also includes a deprecated n field with the same value as transaction_count.
• fpds_top_agencies: array of up to 5 {name, transaction_count, value} objects, top awarding sub-agencies by total $. Each object also includes a deprecated n field.
• fpds_top_agency_share_pct: the single largest top-level department's share of the recipient's FPDS obligations (0 to 100); null when the obligation base is non-positive. The comprehensive customer-concentration signal.
• fpds_top_department: the name of that single largest top-level department, so fpds_top_agency_share_pct reads as a named dependency (note fpds_top_agencies lists sub-agencies; this is the parent department the share is measured on).

Contract vehicles held

The profile also carries the contract vehicles this firm holds as a prime: the IDIQs, GWACs, FSS schedules, and BPAs that task orders are placed against. Holding a vehicle is what makes a firm eligible to bid the orders placed under it, so a firm's vehicle portfolio is a direct read on the work it can pursue. Sourced from FPDS IDV records; read from the separate vehicles dataset, so these fields never change the prime-award totals above.

• vehicles_held_count: total distinct vehicles (by PIID) held under this UEI. Leidos (UE9QJD4KK1L6) reads 32; a large IT integrator like Booz Allen (JCBMLGPE6Z71) reads 498.
• vehicles_held: up to 25 of them, ranked by ceiling. Each entry is {piid, idv_type, awarding_agency_name, naics_code, ceiling, ordering_period_end_date, action_date}. ceiling is the vehicle's potential_total_value_of_award (a thin tail carries FPDS placeholder ceilings, all-nines values, passed through unchanged); ordering_period_end_date is when the vehicle's ordering period closes.

Both zero out (vehicles_held_count: 0, vehicles_held: []) for a firm that holds no vehicles. For the full vehicle record, its ceiling versus what has actually been ordered through it, and who else holds it, follow the PIID to /api/v1/vehicles/{piid}.

SBA small-business profile (sba_profile)

The profile carries an sba_profile sibling block: the firm's SBA Dynamic Small Business Search (DSBS) record, when it has one. DSBS is small-business opt-in, so a firm may have a full award history here and still have no DSBS profile; the block is always present and states which case you are in:

• When the firm has a DSBS profile, sba_profile.in_dsbs is true and the block carries small_business (naics_small_codes, the NAICS the firm is SBA-small for; naics_all_codes; naics_primary; naics_exception_codes), certifications (SBA-registered set-asides with entrance_date / exit_date / status), self_certifications (self-asserted, not SBA-verified, kept separate), capabilities (narrative + keywords), and firmographics. _sources then gains sba_dsbs.
• When the firm has no DSBS profile, the block is exactly {"in_dsbs": false} and _sources does not carry sba_dsbs. This is common: large primes never appear in DSBS.

Read certifications[].status and exit_date, not active alone, before relying on a set-aside; a certification can be Expired or Pending. Every field of the block is named in full on the SBA small-business profile (DSBS) reference page. Example (a small business that is in DSBS):

{
  "uei": "L8GHFAS7N2M1",
  "name": "BZ DEFENSE LLC",
  "...": "SAM registration + award + FPDS/subaward fields above",
  "sba_profile": {
    "in_dsbs": true,
    "small_business": {"naics_small_codes": ["314910", "... 34 codes, includes 541512"], "naics_primary": "423990"},
    "certifications": [
      {"name": "WOSB",   "active": false, "entrance_date": "2022-02-07", "exit_date": "2025-09-15", "status": "Expired"},
      {"name": "EDWOSB", "active": false, "entrance_date": "2022-02-07", "exit_date": "2025-09-15", "status": "Expired"}
    ],
    "self_certifications": ["Minority-Owned Business", "Self-Certified Small Disadvantaged Business", "..."],
    "capabilities": {"narrative": "BZ DEFENSE LLC is a supply chain, technology, and mission support partner ...", "keywords": ["supply", "..."]},
    "firmographics": {"cage_code": "6VZ45", "year_established": "2012", "dba_name": "BZ TACTICAL", "city": "ROUND ROCK", "state": "Texas", "...": "..."},
    "source": "SBA Dynamic Small Business Search (DSBS)"
  },
  "_sources": ["sam_entities", "sam_opportunities", "usaspending_ffata", "usaspending_fpds", "sba_dsbs"]
}

Worked example (Pro response, FPDS + subaward enrichment)

Calling GET /api/v1/companies/CKV2L9GZKJK3 (Deloitte Consulting LLP) on a Pro key returns the SAM profile + award aggregates documented above, plus enrichment fields. Live response excerpt (verified 2026-06-15):

{
  "uei": "CKV2L9GZKJK3",
  "name": "DELOITTE CONSULTING LLP",
  "total_awards": 12,
  "total_value": 1310256763.79,
  "...": "SAM registration + award profile fields above",
  "sub_revenue_total": 126453199.25,
  "top_paying_primes": [
    {"uei": "SMNWM6HN79X5", "name": "GENERAL DYNAMICS INFORMATION TECHNOLOGY, INC.",
     "total": 26501723.69, "subaward_count": 1},
    {"uei": "XDDKMXTVJSN8", "name": "COGNOSANTE MVH LLC",
     "total": 21702000.00, "subaward_count": 1},
    "...up to 10 entries"
  ],
  "prime_revenue_share": 0.971,
  "fpds_obligated_total": 4228940959.11,
  "fpds_distinct_contracts": 914,
  "fpds_transaction_count": 2856,
  "fpds_first_action_date": "2024-10-01",
  "fpds_latest_action_date": "2026-06-12",
  "fpds_top_naics": [
    {"code": "541512", "description": "COMPUTER SYSTEMS DESIGN SERVICES",
     "transaction_count": 913, "n": 913, "value": 2051661176.18},
    {"code": "541611", "description": "ADMINISTRATIVE MANAGEMENT AND GENERAL MANAGEMENT CONSULTING SERVICES",
     "transaction_count": 1142, "n": 1142, "value": 1138031790.98},
    "...up to 5 entries"
  ],
  "fpds_top_agencies": [
    {"name": "Federal Acquisition Service",      "transaction_count": 228, "n": 228, "value": 905220054.81},
    {"name": "Department of Veterans Affairs",   "transaction_count": 70,  "n": 70,  "value": 529603511.82},
    "...up to 5 entries"
  ],
  "_sources": ["sam_entities", "sam_opportunities", "usaspending_ffata", "usaspending_fpds"]
}

Notice the magnitude split: total_value (the SAM-noticed slice, a dozen award notices) is about $1.3B, while fpds_obligated_total (the full prime contract picture, roughly 900+ contracts and several thousand transactions, FY2025 onward) is about $4.3B, more than 3x larger. fpds_obligated_total is the authoritative federal-activity number for this recipient.