FPDS Query Library
About Us
Contact Us

Total Obligated Amount

Monetary amount reported as the total obligated dollars associated with an IDV record in FPDS. It reflects the cumulative obligated value captured for the vehicle, not a count or descriptive label.

Family: IDV
Category: Total Dollar Values
Data Type: numeric
Semantic Type: financial
Mapping: flattened_fpds_xml_field
AI Confidence: high

Variable Overview

FPDS Query Variable
content__IDV__totalDollarValues__totalObligatedAmount
Title
Total Obligated Amount
FPDS Path
IDV/totalDollarValues/totalObligatedAmount
Description
Monetary amount reported as the total obligated dollars associated with an IDV record in FPDS. It reflects the cumulative obligated value captured for the vehicle, not a count or descriptive label.
Business Meaning
This field is used to assess the financial scale of an IDV, support spending and trend analysis, and compare contract vehicles by obligated value. It helps analysts size markets, identify major awards, and review obligation patterns across procurement portfolios.
Example Value
0
Observed Non-Null Count
5,862,557

FPDS Compare

FPDS Query Variable
content__IDV__totalDollarValues__totalObligatedAmount
FPDS XML Path
IDV/totalDollarValues/totalObligatedAmount
Mapping Type
flattened_fpds_xml_field
Comparison Summary
FPDS Query flattens the original nested FPDS XML path 'IDV/totalDollarValues/totalObligatedAmount' into the SQL-ready variable 'content__IDV__totalDollarValues__totalObligatedAmount'.

Use Cases

  • Dictionary lookup and field explanation
  • SQL filtering and grouping
  • Analytical reporting and reusable query building
  • Spending aggregation and trend analysis

Common Usage

  • sum obligated dollars by agency, vendor, or fiscal year
  • rank IDVs by financial size
  • support market sizing and obligation trend analysis

Common Mistakes

  • confusing obligated amount with ceiling, estimated value, or base award amount
  • double counting the same IDV when joining to line-item or modification-level tables

Query Guidance

Use this field in numeric aggregations such as SUM, AVG, MIN, and MAX. When joining to other FPDS tables, deduplicate at the IDV record level before summing to avoid inflated totals, and apply explicit NULL handling if you need to distinguish missing from zero-obligation records.

SQL Examples

Preview values

SELECT
    content__IDV__totalDollarValues__totalObligatedAmount AS total_obligated_amount
FROM fpds.data
WHERE content__IDV__totalDollarValues__totalObligatedAmount IS NOT NULL
LIMIT 25

Aggregate total

SELECT
    sum(content__IDV__totalDollarValues__totalObligatedAmount) AS total_value
FROM fpds.data
WHERE content__IDV__totalDollarValues__totalObligatedAmount IS NOT NULL

Distribution overview

SELECT
    min(content__IDV__totalDollarValues__totalObligatedAmount) AS min_value,
    avg(content__IDV__totalDollarValues__totalObligatedAmount) AS avg_value,
    max(content__IDV__totalDollarValues__totalObligatedAmount) AS max_value,
    count() AS record_count
FROM fpds.data
WHERE content__IDV__totalDollarValues__totalObligatedAmount IS NOT NULL

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