Sanctions Search API: v1

AddCompanySearch

Create a new sanctions search for an entity

This will create a new sanctions search for an entity, such as a company, vessel, organisation, or group.

**AddCompanySearch** Parameters:
Name	Parameter	Data Type	Required	Description
Authentication	body	Authentication	Yes	Authentication object
Request	body	SearchCompanyRequest	Yes	Request object

**Authentication** Parameters:
Name	Parameter	Data Type	Required	Description
ApiUserId	form	string	Yes	The API User ID that will authenticate your request
ApiUserKey	form	string	Yes	The API User Key that will authenticate your request

**SearchCompanyRequest** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyName	form	string	Yes	The name of the entity that is being searched.
Country	form	string	No	The country where the entity is registered.
Address	form	string	No	The address where the entity is registered.
SelectedSanctionsLists	form	ArrayOfSanctionsLists	Yes	Array of sanctions lists to be included in the search. At least one is required.

**AddCompanySearchResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Data	form	AddCompanySearchData	Yes

**AddCompanySearchData** Parameters:
Name	Parameter	Data Type	Required	Description
ResponseStatus	form	ResponseStatus	No
SearchRecord	form	SearchRecord	No

**ResponseStatus** Parameters:
Name	Parameter	Data Type	Required
ErrorCode	form	string	No
Message	form	string	No
StackTrace	form	string	No
Errors	form	ArrayOfResponseError	No

**ResponseError** Parameters:
Name	Parameter	Data Type	Required
ErrorCode	form	string	No
FieldName	form	string	No
Message	form	string	No

**SearchRecord** Parameters:
Name	Parameter	Data Type	Required
Id	form	long	No
SearchType	form	string	No
DateSearched	form	DateTime	No
DateUpdated	form	DateTime	No
NumOfResults	form	int	No
ClientInResults	form	bool	No
ClientNotInResults	form	bool	No
AffectedByUpdate	form	bool	No
SearchCriteria	form	SearchCriteria	No
SearchResults	form	SearchResults	No

**SearchCriteria** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	No
DateOfBirth	form	string	No
CountryOfBirth	form	string	No
Nationality	form	string	No
Address	form	string	No

**SearchResults** Parameters:
Name	Parameter	Data Type	Required	Description
HMTResults	form	List<SearchResultHmTreasury>	No
OfacResults	form	List<SearchResultOfac>	No

**SearchResultHmTreasury** Parameters:
Name	Parameter	Data Type	Required
ResultStrength	form	int	No
ResultSimilarity	form	decimal	No
ResultResolved	form	bool	No
ResultType	form	string	No
DateListed	form	DateTime	No
DateUpdated	form	DateTime	No
Name1	form	string	No
Name2	form	string	No
Name3	form	string	No
Name4	form	string	No
Name5	form	string	No
Name6	form	string	No
DateOfBirth	form	string	No
CountryOfBirth	form	string	No
Nationality	form	string	No
Address1	form	string	No
Address2	form	string	No
Address3	form	string	No
Address4	form	string	No
Address5	form	string	No
Address6	form	string	No
PostCode	form	string	No
Country	form	string	No

**SearchResultOfac** Parameters:
Name	Parameter	Data Type	Required
ResultStrength	form	int	No
ResultSimilarity	form	decimal	No
ResultResolved	form	bool	No
ResultType	form	string	No
DateUpdated	form	DateTime	No
FirstName	form	string	No
LastName	form	string	No
Addresses	form	List<SearchResultOfacAddress>	No
Akas	form	List<SearchResultOfacAka>	No
DateOfBirths	form	List<SearchResultOfacDateOfBirth>	No
Nationalities	form	List<SearchResultOfacNationality>	No
PlaceOfBirths	form	List<SearchResultOfacPlaceOfBirth>	No

**SearchResultOfacAddress** Parameters:
Name	Parameter	Data Type	Required
Address1	form	string	No
Address2	form	string	No
Address3	form	string	No
City	form	string	No
State	form	string	No
PostCode	form	string	No
Country	form	string	No

**SearchResultOfacAka** Parameters:
Name	Parameter	Data Type	Required
FirstName	form	string	No
LastName	form	string	No
Type	form	string	No
Strength	form	string	No

**SearchResultOfacDateOfBirth** Parameters:
Name	Parameter	Data Type	Required	Description
DateOfBirth	form	string	No

**SearchResultOfacNationality** Parameters:
Name	Parameter	Data Type	Required	Description
Country	form	string	No

**SearchResultOfacPlaceOfBirth** Parameters:
Name	Parameter	Data Type	Required	Description
PlaceOfBirth	form	string	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .soap11 suffix or ?format=soap11

HTTP + SOAP11

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /soap11 HTTP/1.1 
Host: api.sanctionssearch.com 
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: AddCompanySearch

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>

<AddCompanySearch xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <Authentication>
    <ApiUserId>String</ApiUserId>
    <ApiUserKey>String</ApiUserKey>
  </Authentication>
  <Request>
    <Address>String</Address>
    <CompanyName>String</CompanyName>
    <Country>String</Country>
    <SelectedSanctionsLists>
      <SanctionsListId>String</SanctionsListId>
    </SelectedSanctionsLists>
  </Request>
</AddCompanySearch>

</soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>

<AddCompanySearchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <Data>
    <ResponseStatus>
      <ErrorCode>String</ErrorCode>
      <Message>String</Message>
      <StackTrace>String</StackTrace>
      <Errors>
        <ResponseError>
          <ErrorCode>String</ErrorCode>
          <FieldName>String</FieldName>
          <Message>String</Message>
        </ResponseError>
      </Errors>
    </ResponseStatus>
    <SearchRecord>
      <AffectedByUpdate>false</AffectedByUpdate>
      <ClientInResults>false</ClientInResults>
      <ClientNotInResults>false</ClientNotInResults>
      <DateSearched>0001-01-01T00:00:00</DateSearched>
      <DateUpdated>0001-01-01T00:00:00</DateUpdated>
      <Id>0</Id>
      <NumOfResults>0</NumOfResults>
      <SearchCriteria>
        <Address>String</Address>
        <CountryOfBirth>String</CountryOfBirth>
        <DateOfBirth>String</DateOfBirth>
        <Name>String</Name>
        <Nationality>String</Nationality>
      </SearchCriteria>
      <SearchResults>
        <HMTResults>
          <SearchResultHmTreasury>
            <Address1>String</Address1>
            <Address2>String</Address2>
            <Address3>String</Address3>
            <Address4>String</Address4>
            <Address5>String</Address5>
            <Address6>String</Address6>
            <Country>String</Country>
            <CountryOfBirth>String</CountryOfBirth>
            <DateListed>0001-01-01T00:00:00</DateListed>
            <DateOfBirth>String</DateOfBirth>
            <DateUpdated>0001-01-01T00:00:00</DateUpdated>
            <Name1>String</Name1>
            <Name2>String</Name2>
            <Name3>String</Name3>
            <Name4>String</Name4>
            <Name5>String</Name5>
            <Name6>String</Name6>
            <Nationality>String</Nationality>
            <PostCode>String</PostCode>
            <ResultResolved>false</ResultResolved>
            <ResultSimilarity>0</ResultSimilarity>
            <ResultStrength>0</ResultStrength>
            <ResultType>String</ResultType>
          </SearchResultHmTreasury>
        </HMTResults>
        <OfacResults>
          <SearchResultOfac>
            <Addresses>
              <SearchResultOfacAddress>
                <Address1>String</Address1>
                <Address2>String</Address2>
                <Address3>String</Address3>
                <City>String</City>
                <Country>String</Country>
                <PostCode>String</PostCode>
                <State>String</State>
              </SearchResultOfacAddress>
            </Addresses>
            <Akas>
              <SearchResultOfacAka>
                <FirstName>String</FirstName>
                <LastName>String</LastName>
                <Strength>String</Strength>
                <Type>String</Type>
              </SearchResultOfacAka>
            </Akas>
            <DateOfBirths>
              <SearchResultOfacDateOfBirth>
                <DateOfBirth>String</DateOfBirth>
              </SearchResultOfacDateOfBirth>
            </DateOfBirths>
            <DateUpdated>0001-01-01T00:00:00</DateUpdated>
            <FirstName>String</FirstName>
            <LastName>String</LastName>
            <Nationalities>
              <SearchResultOfacNationality>
                <Country>String</Country>
              </SearchResultOfacNationality>
            </Nationalities>
            <PlaceOfBirths>
              <SearchResultOfacPlaceOfBirth>
                <PlaceOfBirth>String</PlaceOfBirth>
              </SearchResultOfacPlaceOfBirth>
            </PlaceOfBirths>
            <ResultResolved>false</ResultResolved>
            <ResultSimilarity>0</ResultSimilarity>
            <ResultStrength>0</ResultStrength>
            <ResultType>String</ResultType>
          </SearchResultOfac>
        </OfacResults>
      </SearchResults>
      <SearchType>String</SearchType>
    </SearchRecord>
  </Data>
</AddCompanySearchResponse>

</soap:Body>
</soap:Envelope>