<commit_before>---
layout: dev_resources
title: Using the SAM Web Services
nav: using_SAM_web_services
---
### Using SAM Web Services 
SAM offers web services to search for Entiy data and Excluded Party data.<br>
Entity Managment data can be searched by:<br>
DUNSNumber<br>
CAGECode<br>
taxpayerIdentificationNumber*<br>
startDate & endDate<br>
*Note: TaxpayerIdentificationNumber requires elevated access<br><br>
Exclusions can be searched by:



Here is what you need to get started:

| Web Service Name | Endpoint / WSDL |
|---|---|
| SAM Entity Management | https://gw.sam.gov/SAMWS/1.0/Entity?wsdl |
| __TEST ENDPOINT__ | https://test.sam.gov/SAMWS/1.0/Entity |
| __WSDL FILE__ | https://github.com/GSA/IAE-Architecture/blob/master/as-is/tech-docs/SAM/SAMWSDLsv1.0/Entity.wsdl |
| SAM Exclusion | https://gw.sam.gov/SAMWS/1.0/ExclusionSearch?wsdl |
| __TEST ENDPOINT__ | https://gw.test.sam.gov/SAMWS/1.0/ExclusionSearch |
| __WSDL FILE__ | https://github.com/GSA/IAE-Architecture/blob/master/as-is/tech-docs/SAM/SAMWSDLsv1.0/ExclusionSearch.wsdl |

Test IDs:

| ID Name | Password | Description | Examples of available data*| 
|---|---|---|---|
| SAMPublic | Contact <EMAIL> | EM XML at the public level requires authentication. | includes: name, address, some POC information |
| SAMFOUO | Contact <EMAIL> | For Official Use Only | includes certain types of POC and hierarchy information. |
| SAMSensitive | Contact <EMAIL> | more secure data including banking information and MPIN. |

*A test id is not needed for the SAM Exclusions XML web service. There is no role or authentication requirement.
 
Need more help? Click [here](sam entity management tutorial url in tech-docs) for the SAM entity web service management tutorial.

Tools available:

| Tool Name | Location | Description |
|---|---|---|
| Web Services tutorial | https://github.com/GSA/IAE-Architecture/tree/master/as-is/tech-docs/SAM | Documents how to build an Entity Management web service. |
| Sample XML request/response | https://interact.gsa.gov | Included in the web services tutorial. Various sample request and response for Entity Management. |
| Soap UI project | https://interact.gsa.gov | Project ready for import into Soap UI. (http://www.soapui.org/) |
| SAM Functional Data Dictionary | https://github.com/GSA/IAE-Architecture/blob/master/as-is/tech-docs/SAM/SAM%20Functional%20Data%20Dictionary%20v4.0.pdf |  |
| Web Services Response Schema Documentation |  | Coming Soon! |

If you have questions, please post them to [IAE Transparency Issues](https://github.com/GSA/IAE-Architecture/issues).


<commit_msg>Update Using_SAM_web_services.md<commit_after>---
layout: dev_resources
title: Using the SAM Web Services
nav: using_SAM_web_services
---
### Using SAM Web Services 
SAM offers web services to search for Entiy data and Excluded Party data.<br>
Entity Managment data can be searched by:<br>
DUNSNumber<br>
CAGECode<br>
taxpayerIdentificationNumber*<br>
startDate & endDate<br>
*Note: TaxpayerIdentificationNumber requires elevated access<br><br>
Exclusions can be searched by:



Here is what you need to get started:

| Web Service Name | Endpoint / WSDL |
|---|---|
| SAM Entity Management | https://gw.sam.gov/SAMWS/1.0/Entity?wsdl |
| __TEST ENDPOINT__ | https://test.sam.gov/SAMWS/1.0/Entity |
| __WSDL FILE__ | https://github.com/GSA/IAE-Architecture/blob/master/as-is/tech-docs/SAM/SAMWSDLsv1.0/Entity.wsdl |
| SAM Exclusion | https://gw.sam.gov/SAMWS/1.0/ExclusionSearch?wsdl |
| __TEST ENDPOINT__ | https://gw.test.sam.gov/SAMWS/1.0/ExclusionSearch |
| __WSDL FILE__ | https://github.com/GSA/IAE-Architecture/blob/master/as-is/tech-docs/SAM/SAMWSDLsv1.0/ExclusionSearch.wsdl |

Test IDs:

| ID Name | Password | Description | Examples of available data*| 
|---|---|---|---|
| SAMPublic | Contact <EMAIL> | EM XML at the public level requires authentication. | includes: name, address, some POC information |
| SAMFOUO | Contact <EMAIL> | For Official Use Only | includes certain types of POC and hierarchy information. |
| SAMSensitive | Contact <EMAIL> | more secure data including banking information and MPIN. |

*A test id is not needed for the SAM Exclusions XML web service. There is no role or authentication requirement.
 
Need more help? Click [here](sam entity management tutorial url in tech-docs) for the SAM entity web service management tutorial.

Tools available:

| Tool Name | Description |
|---|---|
| [Web Services tutorial](https://github.com/GSA/IAE-Architecture/tree/master/as-is/tech-docs/SAM) | Documents how to build an Entity Management web service. |
| Sample XML request/response | https://interact.gsa.gov | Included in the web services tutorial. Various sample request and response for Entity Management. |
| Soap UI project | https://interact.gsa.gov | Project ready for import into Soap UI. (http://www.soapui.org/) |
| SAM Functional Data Dictionary | https://github.com/GSA/IAE-Architecture/blob/master/as-is/tech-docs/SAM/SAM%20Functional%20Data%20Dictionary%20v4.0.pdf |  |
| Web Services Response Schema Documentation |  | Coming Soon! |

If you have questions, please post them to [IAE Transparency Issues](https://github.com/GSA/IAE-Architecture/issues).



{'fraction_non_alphanumeric': 0.12127618681529886, 'fraction_numerical': 0.008456659619450317, 'mean_word_length': 4.245967741935484, 'pattern_counts': {'":': 0, '<': 25, '<?xml version=': 0, '>': 25, 'https://': 22, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3868431', 'n_tokens_mistral': 1704, 'n_tokens_neox': 1593, 'n_words': 491}