Base and All Options Value

Numeric field reporting the total contract value including the base award and all option periods if exercised. It represents the maximum obligated scope captured for the award record, not necessarily the amount currently funded or paid.

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

Variable Overview

FPDS Query Variable
content__award__dollarValues__baseAndAllOptionsValue
Title
Base and All Options Value
FPDS Path
award/dollarValues/baseAndAllOptionsValue
Description
Numeric field reporting the total contract value including the base award and all option periods if exercised. It represents the maximum obligated scope captured for the award record, not necessarily the amount currently funded or paid.
Business Meaning
This field is used to compare the full potential size of contracts across vendors, agencies, and time periods. It supports market sizing, obligation-versus-ceiling analysis, and trend analysis where analysts need the total awarded value rather than only the initial base period.
Example Value
0
Observed Non-Null Count
111,509,012

FPDS Compare

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

Use Cases

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

Common Usage

  • Contract size and ceiling analysis
  • Award value trend reporting
  • Vendor and agency spend comparisons

Common Mistakes

  • Confusing total option-inclusive value with obligated dollars paid or currently funded amount
  • Summing this field across multiple modifications or related records without deduplication

Query Guidance

Use the field as a numeric amount in aggregations, filters, and comparisons, and cast or coalesce nulls as needed. When building award-level totals, group at the unique award identifier level before summing to avoid double counting across amendments or repeated extracts.

SQL Examples

Preview values

SELECT
    content__award__dollarValues__baseAndAllOptionsValue AS base_and_all_options_value
FROM fpds.data
WHERE content__award__dollarValues__baseAndAllOptionsValue IS NOT NULL
LIMIT 25

Aggregate total

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

Distribution overview

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