Sanctions Search API: v2

<back to all web services

UpdateClient

Clients
The following routes are available for this service:
PUT/clients/{Id}Update a client when it is PendingVerification
UpdateClient Parameters:
NameParameterData TypeRequiredDescription
IdpathintYes
RequestbodyClientNo
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
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
UpdateClientResponse Parameters:
NameParameterData TypeRequiredDescription
DataformUpdateClientDataNo
UpdateClientData Parameters:
NameParameterData TypeRequiredDescription
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

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

HTTP + XML

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

PUT /clients/{Id} HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<UpdateClient 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>
  <Request>
    <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:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:int>0</d6p1:int>
          </DataGroupsFailed>
          <DataGroupsVerified xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:int>0</d6p1: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>
  </Request>
</UpdateClient>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

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