Sanctions Search API: v2

<back to all web services

GetDbsSearch

DBS
The following routes are available for this service:
GET/dbs/{Id}Get a DBS Search
GetDbsSearch Parameters:
NameParameterData TypeRequiredDescription
IdpathintYesThe ID of the DBS Search
SubUserNamequerystringNoProvide a value to only return a search that the specified sub user has permission to access. If this is null or empty, then sub user permissions will not be enforced and the search will be returned
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).
GetDbsSearchResponse Parameters:
NameParameterData TypeRequiredDescription
DataformGetDbsSearchDataNo
GetDbsSearchData Parameters:
NameParameterData TypeRequiredDescription
LinkedToformArrayOfLinkedToNo
SummaryformDbsSearchSummaryNo
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
DbsSearchSummary Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DateSearchedformDateTimeNo
DateUpdatedformDateTimeNo
StatusformstringNo
DisclosureStatusformstringNo
IsApplicantInfoCompletedformboolNo
IsIdCheckCompletedformboolNo
IsApplicationCompletedformboolNo
IsApplicationSubmittedformboolNo
IsApplicationDisclosedformboolNo
DisclosureLevelformstringNo
ApplicantInformationformApplicantInformationNo
ApplicantInformation Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
DateOfBirthformstringNo
EmailformstringNo
MobileInternationalformstringNo
JobLocationformstringNo
ReferenceformstringNo
ApplicantPinformstringNo

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

GET /dbs/{Id} HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"data":{"linkedTo":[{"clientId":0,"id":0,"type":"String","subtype":"String","status":"String","description":"String","isArchived":false,"name":"String","date":"\/Date(-62135596800000-0000)\/"}],"summary":{"id":0,"dateSearched":"\/Date(-62135596800000-0000)\/","dateUpdated":"\/Date(-62135596800000-0000)\/","status":"String","disclosureStatus":"String","isApplicantInfoCompleted":false,"isIdCheckCompleted":false,"isApplicationCompleted":false,"isApplicationSubmitted":false,"isApplicationDisclosed":false,"disclosureLevel":"String","applicantInformation":{"name":"String","dateOfBirth":"String","email":"String","mobileInternational":"String","jobLocation":"String","reference":"String","applicantPin":"String"}},"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}}