FPDS Query Library
About Us
Contact Us

Obligated Amount

Monetary amount obligated on the IDV record, as reported in FPDS dollar values. It reflects the financial commitment associated with the indefinite delivery vehicle and is captured as a numeric value.

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

Variable Overview

FPDS Query Variable
content__IDV__dollarValues__obligatedAmount
Title
Obligated Amount
FPDS Path
IDV/dollarValues/obligatedAmount
Description
Monetary amount obligated on the IDV record, as reported in FPDS dollar values. It reflects the financial commitment associated with the indefinite delivery vehicle and is captured as a numeric value.
Business Meaning
This field is used to measure the dollar value tied to an IDV for spending analysis, market sizing, portfolio comparisons, and trend reporting. It helps analysts understand the scale of obligations associated with vehicles over time and across agencies or contracting actions.
Example Value
0
Observed Non-Null Count
5,862,557

FPDS Compare

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

Use Cases

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

Common Usage

  • Summing obligated dollars by agency, vendor, or fiscal year
  • Filtering out zero-dollar IDVs in spend analyses
  • Comparing obligation amounts across IDV vehicles or award groups

Common Mistakes

  • Treating this as the ceiling or maximum possible value of the IDV
  • Assuming all records contain nonzero or cumulative obligations

Query Guidance

Use as a numeric measure in SUM, AVG, MIN/MAX, and trend queries, typically grouped by fiscal year, agency, NAICS, or vendor. Include NULL and zero checks explicitly, and join to award or action tables only when you need broader obligation context.

SQL Examples

Preview values

SELECT
    content__IDV__dollarValues__obligatedAmount AS obligated_amount
FROM fpds.data
WHERE content__IDV__dollarValues__obligatedAmount IS NOT NULL
LIMIT 25

Aggregate total

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

Distribution overview

SELECT
    min(content__IDV__dollarValues__obligatedAmount) AS min_value,
    avg(content__IDV__dollarValues__obligatedAmount) AS avg_value,
    max(content__IDV__dollarValues__obligatedAmount) AS max_value,
    count() AS record_count
FROM fpds.data
WHERE content__IDV__dollarValues__obligatedAmount 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.