Sanctions Search API: v2

<back to all web services

UpdateDefaultProofOfDocumentCategories

Clients
The following routes are available for this service:
PUT/clients/proofs/defaultsUpdate the configured default categories of proof and their documents
UpdateDefaultProofOfDocumentCategories Parameters:
NameParameterData TypeRequiredDescription
RequestbodyUpdateDefaultProofOfDocumentCategoriesRequestNo
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. Can be provided in the request body, or as a header parameter (X-Api-User)
ApiUserKeyheader, bodystringYesThe API User Key provided by us when you signed up to use our API. Can be provided in the request body, or as a header parameter (X-Api-Key)
UserIdheader, bodystringNoThe User ID of the user making the request (e.g. a sub user). This is optional but can be used to associate API requests with a specific user, thereby allowing user permissions to be enforced. Can be provided in the body, or as a header parameter (X-User-Id).
UpdateDefaultProofOfDocumentCategoriesRequest Parameters:
NameParameterData TypeRequiredDescription
ProofOfDocumentCategoriesformArrayOfProofOfDocumentCategoriesYes
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
UpdateDefaultProofOfDocumentCategoriesResponse Parameters:
NameParameterData TypeRequiredDescription
DataformUpdateDefaultProofOfDocumentCategoriesDataNo
UpdateDefaultProofOfDocumentCategoriesData Parameters:
NameParameterData TypeRequiredDescription
ProofOfDocumentCategoriesformArrayOfProofOfDocumentCategoriesNo
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/proofs/defaults HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<UpdateDefaultProofOfDocumentCategories xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <Authentication>
    <ApiUserId>String</ApiUserId>
    <ApiUserKey>String</ApiUserKey>
    <UserId>String</UserId>
  </Authentication>
  <Request>
    <ProofOfDocumentCategories>
      <CategoryId>
        <Id>0</Id>
        <ProofOf>String</ProofOf>
        <ProofOfDocuments>
          <DocumentId>
            <Id>0</Id>
            <Name>String</Name>
          </DocumentId>
        </ProofOfDocuments>
      </CategoryId>
    </ProofOfDocumentCategories>
  </Request>
</UpdateDefaultProofOfDocumentCategories>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<UpdateDefaultProofOfDocumentCategoriesResponse 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>
    <ProofOfDocumentCategories>
      <CategoryId>
        <Id>0</Id>
        <ProofOf>String</ProofOf>
        <ProofOfDocuments>
          <DocumentId>
            <Id>0</Id>
            <Name>String</Name>
          </DocumentId>
        </ProofOfDocuments>
      </CategoryId>
    </ProofOfDocumentCategories>
  </Data>
</UpdateDefaultProofOfDocumentCategoriesResponse>