FPDS Query Library
About Us
Contact Us

Agency Id

Identifier for the agency associated with the referenced IDV contract. It is the coded agency key used in the FPDS contract identifier structure, not a narrative agency name.

Family: IDV
Category: Contract Identification
Data Type: identifier_or_code
Semantic Type: identifier
Mapping: flattened_fpds_xml_field
AI Confidence: high

Variable Overview

FPDS Query Variable
content__IDV__contractID__referencedIDVID__agencyID
Title
Agency Id
FPDS Path
IDV/contractID/referencedIDVID/agencyID
Description
Identifier for the agency associated with the referenced IDV contract. It is the coded agency key used in the FPDS contract identifier structure, not a narrative agency name.
Business Meaning
This field lets analysts attribute a referenced IDV to the correct federal agency for ownership, portfolio tracking, and interagency sourcing analysis. It is useful for grouping obligations, identifying which agency administered or owns the vehicle, and linking related awards across procurement datasets.
Example Value
4732
Observed Non-Null Count
133,244

FPDS Compare

FPDS Query Variable
content__IDV__contractID__referencedIDVID__agencyID
FPDS XML Path
IDV/contractID/referencedIDVID/agencyID
Mapping Type
flattened_fpds_xml_field
Comparison Summary
FPDS Query flattens the original nested FPDS XML path 'IDV/contractID/referencedIDVID/agencyID' into the SQL-ready variable 'content__IDV__contractID__referencedIDVID__agencyID'.

Use Cases

  • Dictionary lookup and field explanation
  • SQL filtering and grouping
  • Analytical reporting and reusable query building

Common Usage

  • Join referenced IDVs to agency reference tables or agency names
  • Group contract activity by owning or referencing agency
  • Filter awards tied to a specific agency-issued IDV

Common Mistakes

  • Confusing the agency code with the descriptive agency name
  • Using the value as a unique contract identifier instead of an agency component of the referenced IDV key

Query Guidance

Use this field as a key for joins and aggregation, typically with other contract ID components such as PIID, modification ID, and office/agency reference fields. When filtering or reporting, confirm whether the analysis needs the referenced IDV agency or the awarding agency, since those can differ.

SQL Examples

Preview values

SELECT
    content__IDV__contractID__referencedIDVID__agencyID AS agency_id
FROM fpds.data
WHERE content__IDV__contractID__referencedIDVID__agencyID IS NOT NULL
LIMIT 25

Top values

SELECT
    content__IDV__contractID__referencedIDVID__agencyID AS value,
    count() AS record_count
FROM fpds.data
WHERE content__IDV__contractID__referencedIDVID__agencyID 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.