FPDS Query Library
About Us
Contact Us

Cage Code

CAGE code assigned to the vendor site associated with the IDV record. It is a standardized alphanumeric identifier used to distinguish the specific contractor location or entity represented in FPDS.

Family: IDV
Category: Vendor Site Details
Data Type: identifier_or_code
Semantic Type: identifier
Mapping: flattened_fpds_xml_field
AI Confidence: high

Variable Overview

FPDS Query Variable
content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode
Title
Cage Code
FPDS Path
IDV/vendor/vendorSiteDetails/entityIdentifiers/cageCode
Description
CAGE code assigned to the vendor site associated with the IDV record. It is a standardized alphanumeric identifier used to distinguish the specific contractor location or entity represented in FPDS.
Business Meaning
This field supports vendor identity resolution, contractor profiling, and linkage to other federal procurement and entity datasets. Analysts use it to aggregate obligations by supplier site, track awards across solicitations and vehicles, and detect concentration, duplication, or vendor-spend patterns.
Example Value
3JEH0
Observed Non-Null Count
2,263,407

FPDS Compare

FPDS Query Variable
content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode
FPDS XML Path
IDV/vendor/vendorSiteDetails/entityIdentifiers/cageCode
Mapping Type
flattened_fpds_xml_field
Comparison Summary
FPDS Query flattens the original nested FPDS XML path 'IDV/vendor/vendorSiteDetails/entityIdentifiers/cageCode' into the SQL-ready variable 'content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode'.

Use Cases

  • Dictionary lookup and field explanation
  • SQL filtering and grouping
  • Analytical reporting and reusable query building
  • Contractor profiling and competitor analysis

Common Usage

  • Vendor matching and deduplication
  • Spend concentration analysis by contractor site
  • Joining to external CAGE/entity reference data

Common Mistakes

  • Assuming it identifies the parent company rather than the specific site/entity
  • Using it as a human-readable label instead of a code

Query Guidance

Use this field for exact-match filtering, grouping, and joins to reference tables. In SQL, normalize blanks/nulls before aggregation and avoid fuzzy matching unless reconciling inconsistent source values; if analyzing vendors, pair it with vendor name and site details to verify entity identity.

SQL Examples

Preview values

SELECT
    content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode AS cage_code
FROM fpds.data
WHERE content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode IS NOT NULL
LIMIT 25

Top values

SELECT
    content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode AS value,
    count() AS record_count
FROM fpds.data
WHERE content__IDV__vendor__vendorSiteDetails__entityIdentifiers__cageCode IS NOT NULL
GROUP BY value
ORDER BY record_count DESC
LIMIT 25

Each dictionary item includes SQL-ready examples generated alongside the variable metadata, allowing immediate use in FPDS Query for filtering, aggregation, and analysis.