FPDS Query Library
About Us
Contact Us

Total Base and Exercised Options Value

Monetary value of the award equal to the base contract amount plus any exercised options. It represents the obligated value of work that is currently in force, excluding unexercised option amounts and other potential future value.

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

Variable Overview

FPDS Query Variable
content__award__totalDollarValues__totalBaseAndExercisedOptionsValue
Title
Total Base and Exercised Options Value
FPDS Path
award/totalDollarValues/totalBaseAndExercisedOptionsValue
Description
Monetary value of the award equal to the base contract amount plus any exercised options. It represents the obligated value of work that is currently in force, excluding unexercised option amounts and other potential future value.
Business Meaning
This field is a core measure for comparing reported contract value across awards, vendors, agencies, and time periods. Analysts use it to estimate committed spending, size awards, and support market sizing, obligation trend analysis, and portfolio reviews.
Example Value
30134631901.85
Observed Non-Null Count
111,508,709

FPDS Compare

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

Use Cases

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

Common Usage

  • Total obligated value by agency, vendor, or product/service category
  • Award size distributions and percentile analysis
  • Filtering large awards for oversight or market research

Common Mistakes

  • Treating it as the full potential ceiling value, including unexercised options
  • Summing multiple rows for the same award without deduplicating or using the correct transaction grain

Query Guidance

Use this numeric field for SUM, AVG, MIN/MAX, and threshold filters, but first confirm the row grain and whether the table contains one record per award or multiple award actions. When comparing against total potential value, use a separate field for unexercised options; when validating data, inspect nulls and outliers and cast to a numeric type suitable for currency calculations.

SQL Examples

Preview values

SELECT
    content__award__totalDollarValues__totalBaseAndExercisedOptionsValue AS total_base_and_exercised_options_value
FROM fpds.data
WHERE content__award__totalDollarValues__totalBaseAndExercisedOptionsValue IS NOT NULL
LIMIT 25

Aggregate total

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

Distribution overview

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