FPDS Query Library
About Us
Contact Us

Total Base and All Options Value

Numeric contract value representing the reported total dollar amount for the base award plus all option periods or quantities. It is a monetary measure of the full potential award value as recorded in FPDS for the award action.

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__totalBaseAndAllOptionsValue
Title
Total Base and All Options Value
FPDS Path
award/totalDollarValues/totalBaseAndAllOptionsValue
Description
Numeric contract value representing the reported total dollar amount for the base award plus all option periods or quantities. It is a monetary measure of the full potential award value as recorded in FPDS for the award action.
Business Meaning
This field is used to size awards, compare contract magnitudes, and support obligation and spend trend analysis across vendors, agencies, and product/service categories. It helps analysts distinguish small base awards from larger commitments that include exercised or available options, which is important for market sizing and portfolio reviews.
Example Value
96140731
Observed Non-Null Count
111,509,024

FPDS Compare

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

Use Cases

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

Common Usage

  • Award size analysis
  • Agency or vendor spend trend comparison
  • Market sizing and competitive landscape analysis

Common Mistakes

  • Treating the value as actual obligations or expenditures
  • Double-counting multiple versions of the same award action without deduplication

Query Guidance

Select, cast, and aggregate this field as a numeric amount after filtering to the desired award version or latest action. Use it for sums, averages, percentiles, and value thresholds, but apply de-duplication logic when records include amendments or repeated award rows.

SQL Examples

Preview values

SELECT
    content__award__totalDollarValues__totalBaseAndAllOptionsValue AS total_base_and_all_options_value
FROM fpds.data
WHERE content__award__totalDollarValues__totalBaseAndAllOptionsValue IS NOT NULL
LIMIT 25

Aggregate total

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

Distribution overview

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