Field reference for public SAM data
The fields listed here match up to the SAM data as defined in the public data extract available on SAM. The documentation for the extract is available on the openIAE site here. There are a few fields like the NAICS code which have been broken out into objects or arrays. The documentation will be updated to provide more information about how to expect those codes to be sent to the user, but most of the fields are one-to-one mapped from the public extract file.
This Excel file contains reference data for
- country codes
- metropolitan statistical areas
- county codes
- FAR clause identifiers
- DFAR clause identifiers
We are working on improving access to the information on SAM. If you are directly integrating with SAM and need information about this or other interfaces into SAM, you can go to Interact, sign up, and then contact the your Change Control Board member to get access to the SAM Interfaces and Extracts Working Group forum.
SAM Public Data Fields
| Field name | Description | Data type |
|---|
Common RESTful API Objects
Address Object
An address is represented by a JSON object with a structure as follows:
{
"line1": "1800 F St NW",
"line2": "IAE Offices",
"city": "Washington",
"stateOrProvince": "DC",
"zip": "20504",
"zip4": "0000",
"countryCode": "USA"
}
Note that city and zip4 are optional.
The countryCode is a 3-digit code based on the GENC standard which is derived from ISO-3166-1 alpha-3 code. In March, the SAM API will also include West Bank, Gaza Strip and Kosovo in the country codes.
Point of Contact Object
A point of contact object references an individual that is tied to a SAM registration for a particular purpose (e.g., a government point of contact, a point of contact dedicated to past performance reporting, etc.). A point of contact is represented by an object wth a structure as follows:
{
"firstName": "John",
"middleInitial": "Z",
"lastName": "Smith",
"address": { -- address object -- }
"usPhone": "555-555-5555",
"usPhoneExt": "000",
"nonUsPhone": "105055555555",
"nonUsPhoneExt": "000",
"email": "example@example.com"
}
Note that only firstName, lastName, email and one phone number is required.