Sanctions Search API: v2

<back to all web services

RegisterAccount

Create a new account
RegisterAccount Parameters:
NameParameterData TypeRequiredDescription
RequestbodyRegisterAccountRequestNo
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
Authenticationheader, bodyAuthenticationYesThe authentication credentials
Authentication Parameters:
NameParameterData TypeRequiredDescription
ApiUserIdheader, bodystringYesThe API User ID provided by us when you signed up to use our API
ApiUserKeyheader, bodystringYesThe API User Key provided by us when you signed up to use our API
RegisterAccountRequest Parameters:
NameParameterData TypeRequiredDescription
UsernameformstringYesThe desired login username for the account
PasswordformstringYesThe password for account login
EmailformstringYesThe contact email address for the account holder
FullNameformstringYesThe full legal name of the account holder
CompanyNameformstringYesThe registered name of the company associated with this account
CompanyPhoneformstringYesThe primary contact phone number of the company
Address1formstringYesThe first line of the company’s address (e.g., street name and number)
Address2formstringNoThe second line of the company’s address (optional)
Address3formstringNoThe third line of the company’s address (optional)
CityformstringNoThe city where the company is located (optional)
PostcodeformstringYesThe postal or ZIP code of the company’s address
CountryformstringYesThe country where the company is registered
CompanyTypeformstringYesThe classification of the company (e.g., LLC, Corporation, Sole Proprietorship)
CompanyIndustryformstringYesThe industry sector the company operates in
CompanyNetworkformstringNoThe trade body, network, or affiliation the company is a member of (if applicable)
AgreeToTermsformboolYesIndicates agreement to the terms and conditions (required)
AgreeToDataProtectionformboolYesIndicates agreement to the data protection statement (required)
AgreeToContactformboolNoIndicates consent to be contacted (optional)
AgreeToPrivacyformboolYesIndicates agreement to the privacy policy (required)
VoucherCodeformstringNoAn optional voucher code for discounts or promotions
AccountActivationCodeformstringNoAn optional code that grants access to certain features or subscriptions
VATNumberformstringNoThe company's VAT registration number (if applicable)
VATCountryformstringNoThe country where the company is VAT-registered
RegisterAccountResponse Parameters:
NameParameterData TypeRequiredDescription
DataformRegisterAccountDataNoThe response data
RegisterAccountData Parameters:
NameParameterData TypeRequiredDescription
ApiUserIdformstringNoA unique identifier for the users API access
ApiUserKeyformstringNoA secure, randomly generated key used for API authentication
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNoThe status of the response
ResponseStatus Parameters:
NameParameterData TypeRequiredDescription
ErrorCodeformstringNo
MessageformstringNo
StackTraceformstringNo
ErrorsformArrayOfResponseErrorNo
MetaformDictionary<string, string>No
ResponseError Parameters:
NameParameterData TypeRequiredDescription
ErrorCodeformstringNo
FieldNameformstringNo
MessageformstringNo
MetaformDictionary<string, string>No

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

HTTP + SOAP12

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

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

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

<RegisterAccount xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <Authentication>
    <ApiUserId>String</ApiUserId>
    <ApiUserKey>String</ApiUserKey>
  </Authentication>
  <Request>
    <AccountActivationCode>String</AccountActivationCode>
    <Address1>String</Address1>
    <Address2>String</Address2>
    <Address3>String</Address3>
    <AgreeToContact>false</AgreeToContact>
    <AgreeToDataProtection>false</AgreeToDataProtection>
    <AgreeToPrivacy>false</AgreeToPrivacy>
    <AgreeToTerms>false</AgreeToTerms>
    <City>String</City>
    <CompanyIndustry>String</CompanyIndustry>
    <CompanyName>String</CompanyName>
    <CompanyNetwork>String</CompanyNetwork>
    <CompanyPhone>String</CompanyPhone>
    <CompanyType>String</CompanyType>
    <Country>String</Country>
    <Email>String</Email>
    <FullName>String</FullName>
    <Password>String</Password>
    <Postcode>String</Postcode>
    <Username>String</Username>
    <VATCountry>String</VATCountry>
    <VATNumber>String</VATNumber>
    <VoucherCode>String</VoucherCode>
  </Request>
</RegisterAccount>

</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

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

<RegisterAccountResponse 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>
          <Meta xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:KeyValueOfstringstring>
              <d6p1:Key>String</d6p1:Key>
              <d6p1:Value>String</d6p1:Value>
            </d6p1:KeyValueOfstringstring>
          </Meta>
        </ResponseError>
      </Errors>
      <Meta xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </Meta>
    </ResponseStatus>
    <ApiUserId>String</ApiUserId>
    <ApiUserKey>String</ApiUserKey>
  </Data>
</RegisterAccountResponse>

</soap12:Body>
</soap12:Envelope>