FPDS Query Library
About Us
Contact Us

Mod Number

Modification number assigned to an award action. It identifies the specific amendment, extension, or change within the award history and is stored as an identifier/code rather than a free-text description.

Family: Award
Category: Award Identification
Data Type: identifier_or_code
Semantic Type: identifier
Mapping: flattened_fpds_xml_field
AI Confidence: high

Variable Overview

FPDS Query Variable
content__award__awardID__awardContractID__modNumber
Title
Mod Number
FPDS Path
award/awardID/awardContractID/modNumber
Description
Modification number assigned to an award action. It identifies the specific amendment, extension, or change within the award history and is stored as an identifier/code rather than a free-text description.
Business Meaning
This field is essential for distinguishing one version of an award from another when tracking award lifecycle changes, obligation updates, and post-award actions. It supports analysis of modification frequency, timing, and the sequence of contractual changes across the same base award.
Example Value
A056
Observed Non-Null Count
111,509,025

FPDS Compare

FPDS Query Variable
content__award__awardID__awardContractID__modNumber
FPDS XML Path
award/awardID/awardContractID/modNumber
Mapping Type
flattened_fpds_xml_field
Comparison Summary
FPDS Query flattens the original nested FPDS XML path 'award/awardID/awardContractID/modNumber' into the SQL-ready variable 'content__award__awardID__awardContractID__modNumber'.

Use Cases

  • Dictionary lookup and field explanation
  • SQL filtering and grouping
  • Analytical reporting and reusable query building

Common Usage

  • Identify the latest modification for an award
  • Reconstruct award chronology across actions
  • Deduplicate records at the modification level

Common Mistakes

  • Treating the value as a numeric amount or count
  • Joining or sorting after stripping leading zeros or letters

Query Guidance

Use this field with the base award identifiers to partition award history and select the correct modification sequence. In SQL, preserve it as text, and when determining the most recent record use the full award key plus a stable sort on modification order rather than casting to number.

SQL Examples

Preview values

SELECT
    content__award__awardID__awardContractID__modNumber AS mod_number
FROM fpds.data
WHERE content__award__awardID__awardContractID__modNumber IS NOT NULL
LIMIT 25

Top values

SELECT
    content__award__awardID__awardContractID__modNumber AS value,
    count() AS record_count
FROM fpds.data
WHERE content__award__awardID__awardContractID__modNumber IS NOT NULL
GROUP BY value
ORDER BY record_count DESC
LIMIT 25

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