Sanctions Search API: v2

<back to all web services

GetClient

GetClient Parameters:
NameParameterData TypeRequiredDescription
IdpathintYes
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
GetClientResponse Parameters:
NameParameterData TypeRequiredDescription
DataformGetClientDataNo
GetClientData Parameters:
NameParameterData TypeRequiredDescription
LinkedToformArrayOfLinkedToNo
ClientformClientNo
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
LinkedTo Parameters:
NameParameterData TypeRequiredDescription
ClientIdformint?No
Idformlong?No
TypeformstringNo
SubtypeformstringNo
StatusformstringNo
DescriptionformstringNo
IsArchivedformbool?No
NameformstringNo
DateformDateTime?No
Client Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
DateCreatedformDateTimeNo
NameformstringNo
EmailformstringNo
ReferenceformstringNo
StateformClientStateNo
MobileInternationalformstringNo
PostCodeformstringNo
IsValidateMeformboolNo
FaceformFaceNo
VideoformVideoNo
LocationformLocationNo
NumOfDocumentsformintNo
PassportsformArrayOfPassportsNo
DrivingLicencesformArrayOfDrivingLicencesNo
OtherDocumentsformArrayOfOtherDocumentsNo
ProofOfDocumentCategoriesformArrayOfProofOfDocumentCategoriesNo
ClientState Enum:
Undefined
PendingCompletion
PendingOcr
PendingVerification
Verified
Face Parameters:
NameParameterData TypeRequiredDescription
Ageformdouble?No
GenderformstringNo
EmotionformstringNo
Smileformdouble?No
HairColourformstringNo
FacialHairformstringNo
MakeupformstringNo
GlassesformstringNo
AccessoriesformstringNo
Video Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
VideoUrlformstringNo
ImageUrlformstringNo
VideoTimestampsformList<VideoTimestamp>No
VideoTimestamp Parameters:
NameParameterData TypeRequiredDescription
TagNameformstringNo
Milliformint?No
ImageUrlformstringNo
Location Parameters:
NameParameterData TypeRequiredDescription
LatitudeformdoubleNo
LongitudeformdoubleNo
Passport Parameters:
NameParameterData TypeRequiredDescription
ClientFileIdformintNo
FirstNameformstringNo
MiddleNameformstringNo
LastNameformstringNo
DateOfBirthformstringNo
GenderformstringNo
MrzLineOneformstringNo
MrzLineTwo1formstringNo
MrzLineTwo2formstringNo
MrzLineTwo3formstringNo
MrzLineTwo4formstringNo
MrzLineTwo5formstringNo
MrzLineTwo6formstringNo
MrzLineTwo7formstringNo
MrzLineTwo8formstringNo
ImagesformArrayOfImagesNo
IsVerifiedformboolNo
IsFaceMatchformbool?No
FaceMatchConfidenceformdecimal?No
HasPcvSearchformboolNo
HasDfaSearchformboolNo
IsPassportChipVerifiedformbool?No
PassportChipDataformPassportChipDataNo
IsEligibleForPcvformboolNo
IsEligibleForDfaformboolNo
Image Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
OcrIdformint?No
UrlformstringNo
PassportChipData Parameters:
NameParameterData TypeRequiredDescription
IsIssuerVerifiedformboolNo
IssuerCommonNameformstringNo
IssuerOrganisationNameformstringNo
IssuerCountryformstringNo
MRZLine1formstringNo
MRZLine2formstringNo
IsMrzLine1VerifiedformboolNo
IsMrzLine2VerifiedformboolNo
DataGroupsVerifiedformint[]No
DataGroupsFailedformint[]No
IsFaceMatchformboolNo
FaceMatchConfidenceformdecimal?No
DrivingLicence Parameters:
NameParameterData TypeRequiredDescription
ClientFileIdformintNo
FirstNameformstringNo
MiddleNameformstringNo
LastNameformstringNo
DateOfBirthformstringNo
AddressformstringNo
DrivingLicenceNumberformstringNo
ImagesformArrayOfImagesNo
IsVerifiedformboolNo
IsFaceMatchformbool?No
FaceMatchConfidenceformdecimal?No
HasDfaSearchformboolNo
OtherDocument Parameters:
NameParameterData TypeRequiredDescription
ClientFileIdformintNo
TypeformstringNo
TypeOtherformstringNo
DescriptionformstringNo
OriginalImageUrlformstringNo
CroppedImageUrlformstringNo
IsVerifiedformboolNo
ProofOfDocumentCategory Parameters:
NameParameterData TypeRequiredDescription
IdformintYesThe ID of the ProofOfDocumentCategory
ProofOfformstringYesThe category or subject that requires proof (e.g., 'Name', 'Address', 'Right to work')
ProofOfDocumentsformArrayOfProofOfDocumentsYesThe documents that can be used to provide proof for the specified category.
ProofOfDocument Parameters:
NameParameterData TypeRequiredDescription
IdformintYesThe ID of the ProofOfDocument
NameformstringYesThe name of the ProofOfDocument

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: GetClient

<?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>

<GetClient xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <Authentication>
    <ApiUserId>String</ApiUserId>
    <ApiUserKey>String</ApiUserKey>
  </Authentication>
  <Id>0</Id>
</GetClient>

</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>

<GetClientResponse 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>
    <Client>
      <DateCreated>0001-01-01T00:00:00</DateCreated>
      <DrivingLicences>
        <Passport>
          <Address>String</Address>
          <ClientFileId>0</ClientFileId>
          <DateOfBirth>String</DateOfBirth>
          <DrivingLicenceNumber>String</DrivingLicenceNumber>
          <FaceMatchConfidence>0</FaceMatchConfidence>
          <FirstName>String</FirstName>
          <HasDfaSearch>false</HasDfaSearch>
          <Images>
            <CategoryId>
              <Id>0</Id>
              <Name>String</Name>
              <OcrId>0</OcrId>
              <Url>String</Url>
            </CategoryId>
          </Images>
          <IsFaceMatch>false</IsFaceMatch>
          <IsVerified>false</IsVerified>
          <LastName>String</LastName>
          <MiddleName>String</MiddleName>
        </Passport>
      </DrivingLicences>
      <Email>String</Email>
      <Face>
        <Accessories>String</Accessories>
        <Age>0</Age>
        <Emotion>String</Emotion>
        <FacialHair>String</FacialHair>
        <Gender>String</Gender>
        <Glasses>String</Glasses>
        <HairColour>String</HairColour>
        <Makeup>String</Makeup>
        <Smile>0</Smile>
      </Face>
      <Id>0</Id>
      <IsValidateMe>false</IsValidateMe>
      <Location>
        <Latitude>0</Latitude>
        <Longitude>0</Longitude>
      </Location>
      <MobileInternational>String</MobileInternational>
      <Name>String</Name>
      <NumOfDocuments>0</NumOfDocuments>
      <OtherDocuments>
        <OtherDocument>
          <ClientFileId>0</ClientFileId>
          <CroppedImageUrl>String</CroppedImageUrl>
          <Description>String</Description>
          <IsVerified>false</IsVerified>
          <OriginalImageUrl>String</OriginalImageUrl>
          <Type>String</Type>
          <TypeOther>String</TypeOther>
        </OtherDocument>
      </OtherDocuments>
      <Passports>
        <Passport>
          <ClientFileId>0</ClientFileId>
          <DateOfBirth>String</DateOfBirth>
          <FaceMatchConfidence>0</FaceMatchConfidence>
          <FirstName>String</FirstName>
          <Gender>String</Gender>
          <HasDfaSearch>false</HasDfaSearch>
          <HasPcvSearch>false</HasPcvSearch>
          <Images>
            <CategoryId>
              <Id>0</Id>
              <Name>String</Name>
              <OcrId>0</OcrId>
              <Url>String</Url>
            </CategoryId>
          </Images>
          <IsEligibleForDfa>false</IsEligibleForDfa>
          <IsEligibleForPcv>false</IsEligibleForPcv>
          <IsFaceMatch>false</IsFaceMatch>
          <IsPassportChipVerified>false</IsPassportChipVerified>
          <IsVerified>false</IsVerified>
          <LastName>String</LastName>
          <MiddleName>String</MiddleName>
          <MrzLineOne>String</MrzLineOne>
          <MrzLineTwo1>String</MrzLineTwo1>
          <MrzLineTwo2>String</MrzLineTwo2>
          <MrzLineTwo3>String</MrzLineTwo3>
          <MrzLineTwo4>String</MrzLineTwo4>
          <MrzLineTwo5>String</MrzLineTwo5>
          <MrzLineTwo6>String</MrzLineTwo6>
          <MrzLineTwo7>String</MrzLineTwo7>
          <MrzLineTwo8>String</MrzLineTwo8>
          <PassportChipData>
            <DataGroupsFailed xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
              <d7p1:int>0</d7p1:int>
            </DataGroupsFailed>
            <DataGroupsVerified xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
              <d7p1:int>0</d7p1:int>
            </DataGroupsVerified>
            <FaceMatchConfidence>0</FaceMatchConfidence>
            <IsFaceMatch>false</IsFaceMatch>
            <IsIssuerVerified>false</IsIssuerVerified>
            <IsMrzLine1Verified>false</IsMrzLine1Verified>
            <IsMrzLine2Verified>false</IsMrzLine2Verified>
            <IssuerCommonName>String</IssuerCommonName>
            <IssuerCountry>String</IssuerCountry>
            <IssuerOrganisationName>String</IssuerOrganisationName>
            <MRZLine1>String</MRZLine1>
            <MRZLine2>String</MRZLine2>
          </PassportChipData>
        </Passport>
      </Passports>
      <PostCode>String</PostCode>
      <ProofOfDocumentCategories>
        <CategoryId>
          <Id>0</Id>
          <ProofOf>String</ProofOf>
          <ProofOfDocuments>
            <DocumentId>
              <Id>0</Id>
              <Name>String</Name>
            </DocumentId>
          </ProofOfDocuments>
        </CategoryId>
      </ProofOfDocumentCategories>
      <Reference>String</Reference>
      <State>Undefined</State>
      <Video>
        <Id>0</Id>
        <ImageUrl>String</ImageUrl>
        <VideoTimestamps>
          <VideoTimestamp>
            <ImageUrl>String</ImageUrl>
            <Milli>0</Milli>
            <TagName>String</TagName>
          </VideoTimestamp>
        </VideoTimestamps>
        <VideoUrl>String</VideoUrl>
      </Video>
    </Client>
    <LinkedTo>
      <LinkedTo>
        <ClientId>0</ClientId>
        <Date>0001-01-01T00:00:00</Date>
        <Description>String</Description>
        <Id>0</Id>
        <IsArchived>false</IsArchived>
        <Name>String</Name>
        <Status>String</Status>
        <Subtype>String</Subtype>
        <Type>String</Type>
      </LinkedTo>
    </LinkedTo>
  </Data>
</GetClientResponse>

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