# Data dictionary

Every field the API returns, its source system and field name, and what to watch for. All fields are public tier.

| Field | Resource | Type | Meaning | Source field | Refresh |
| --- | --- | --- | --- | --- | --- |
| uei | entity | string | Unique Entity ID: the 12-character identifier SAM.gov assigns to every registered entity. | SAM.gov Entity Registration extract: ueiSAM | From the latest public extract; the date is in meta.as_of |
| cage | entity | string | Commercial and Government Entity code, assigned by the Defense Logistics Agency. | SAM.gov Entity Registration extract: cageCode | From the latest public extract; the date is in meta.as_of |
| legal_name | entity | string | The entity's legal business name as registered. | SAM.gov Entity Registration extract: legalBusinessName | From the latest public extract; the date is in meta.as_of |
| dba_name | entity | string | Doing-business-as name, when one is registered. | SAM.gov Entity Registration extract: dbaName | From the latest public extract; the date is in meta.as_of |
| registration_status | entity | string | Whether the SAM.gov registration is currently active or has expired. | SAM.gov Entity Registration extract: registrationStatus | From the latest public extract; the date is in meta.as_of |
| purpose | entity | string | Purpose of registration: all awards, or federal assistance awards only. | SAM.gov Entity Registration extract: purposeOfRegistrationCode | From the latest public extract; the date is in meta.as_of |
| registration_date | entity | date | When the entity first registered in SAM.gov. | SAM.gov Entity Registration extract: registrationDate | From the latest public extract; the date is in meta.as_of |
| activation_date | entity | date | When the current registration was last activated (renewed). | SAM.gov Entity Registration extract: activationDate | From the latest public extract; the date is in meta.as_of |
| expiration_date | entity | date | When the current registration expires unless renewed. Registrations are renewed every 365 days. | SAM.gov Entity Registration extract: registrationExpirationDate | From the latest public extract; the date is in meta.as_of |
| last_update_date | entity | date | When the registration record last changed. | SAM.gov Entity Registration extract: lastUpdateDate | From the latest public extract; the date is in meta.as_of |
| entity_structure | entity | string | Legal structure code, such as corporate entity or partnership. | SAM.gov Entity Registration extract: entityStructureCode | From the latest public extract; the date is in meta.as_of |
| is_individual | entity | boolean | True for a sole proprietorship registered under a person's name. | SAM.gov Entity Registration extract: derived from entityStructureCode | From the latest public extract; the date is in meta.as_of |
| state | entity | string | State of the physical address. | SAM.gov Entity Registration extract: physicalAddress.stateOrProvinceCode | From the latest public extract; the date is in meta.as_of |
| congressional_district | entity | string | Congressional district of the physical address. | SAM.gov Entity Registration extract: congressionalDistrict | From the latest public extract; the date is in meta.as_of |
| primary_naics | entity | string | The NAICS code the entity marks as primary. | SAM.gov Entity Registration extract: primaryNaics | From the latest public extract; the date is in meta.as_of |
| naics | entity | string[] | Every NAICS code the entity lists. | SAM.gov Entity Registration extract: naicsCode[] | From the latest public extract; the date is in meta.as_of |
| naics_small | entity | string[] | NAICS codes for which the entity represents itself as small. | SAM.gov Entity Registration extract: naicsCode[].sbaSmallBusiness | From the latest public extract; the date is in meta.as_of |
| psc | entity | string[] | Product and service codes the entity lists. | SAM.gov Entity Registration extract: pscCode[] | From the latest public extract; the date is in meta.as_of |
| business_types | entity | string[] | SAM.gov business type codes, such as woman-owned or veteran-owned. | SAM.gov Entity Registration extract: businessTypeList[] | From the latest public extract; the date is in meta.as_of |
| sba_certs | entity | object[] | SBA program certifications with entry and exit dates. | SAM.gov Entity Registration extract: sbaBusinessTypeList[] | From the latest public extract; the date is in meta.as_of |
| exclusion_flag | entity | boolean | True when the registration shows an active exclusion. | SAM.gov Entity Registration extract: exclusionStatusFlag | From the latest public extract; the date is in meta.as_of |
| notice_id | opportunity | string | SAM.gov notice ID; the public notice is at https://sam.gov/opp/{notice_id}/view. | SAM.gov Contract Opportunities: noticeId | Nightly |
| solicitation_number | opportunity | string | The agency's solicitation number. | SAM.gov Contract Opportunities: solicitationNumber | Nightly |
| type | opportunity | string | Notice type, such as Presolicitation, Solicitation, Sources Sought or Award Notice. | SAM.gov Contract Opportunities: type | Nightly |
| set_aside_code | opportunity | string | Set-aside code, such as SBA (total small business), 8A, WOSB or SDVOSBC. | SAM.gov Contract Opportunities: typeOfSetAside | Nightly |
| response_deadline | opportunity | datetime | When responses are due, stored in UTC. | SAM.gov Contract Opportunities: responseDeadLine | Nightly |
| naics | opportunity | string | NAICS code on the notice. | SAM.gov Contract Opportunities: naicsCode | Nightly |
| psc | opportunity | string | Product and service (classification) code on the notice. | SAM.gov Contract Opportunities: classificationCode | Nightly |
| contacts | opportunity | object[] | Points of contact as printed in the public notice. Pro and Scale plans. | SAM.gov Contract Opportunities: pointOfContact[] | Nightly |
| active | opportunity | boolean | Whether the notice is still open. | SAM.gov Contract Opportunities: active | Nightly |
| classification | exclusion | string | Firm, Individual, Vessel or Special Entity Designation. | SAM.gov Exclusions extract: classificationType | Daily |
| exclusion_type | exclusion | string | What the exclusion bars. | SAM.gov Exclusions extract: exclusionType | Daily |
| excluding_agency | exclusion | string | The agency that took the action. | SAM.gov Exclusions extract: excludingAgencyCode | Daily |
| termination_date | exclusion | date | When the exclusion ends; empty means indefinite. | SAM.gov Exclusions extract: terminationDate | Daily |
| award_id | award | string | USAspending's generated unique award id. | USAspending: generated_unique_award_id | Nightly |
| piid | award | string | Procurement instrument identifier: the contract number. | USAspending: piid | Nightly |
| obligated | award | number | Dollars obligated to date. | USAspending: total_obligation | Nightly |
| potential_end_date | award | date | Last date of performance if every option is exercised. | USAspending: period_of_performance_potential_end_date | Nightly |
| recipient_uei | award | string | The awardee's UEI. | USAspending: recipient_uei | Nightly |
| size_standard_usd | naics | number | SBA size standard in average annual receipts for the NAICS code. | Census NAICS and SBA size standards: 13 CFR 121.201 table | When SBA publishes a final rule |
| current_price | labor_rate | number | Ceiling hourly rate on the GSA schedule contract for the current year. | GSA CALC+: current_price | Weekly |

Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.


Get a free API key: https://samgovapi.io/sign-up?ref=ai-claudebot