Sanctions Search API: v2

<back to all web services

GetDbsSearches

DBS
The following routes are available for this service:
GET/dbsGet all DBS Searches
GetDbsSearches Parameters:
NameParameterData TypeRequiredDescription
NamequerystringNoFilter the results to those that have a Name including the specified value
DateFromqueryDateTime?NoFilter the results to those that were created after (or on) this date
DateToqueryDateTime?NoFilter the results to those that were created before this date
IsApplicantInfoCompletedquerybool?NoFilter the results to those where the applicant has provided their information (true), or not (false), or either (null)
IsIdCheckCompletedquerybool?NoFilter the results to those where the ID Checker has verified the applicant's ID (true), or not (false), or either (null)
IsApplicationCompletedquerybool?NoFilter the results to those where the application is complete and ready to be submitted (true), or not (false), or either (null)
IsApplicationSubmittedquerybool?NoFilter the results to those where the application has been submitted (true), or not (false), or either (null)
IsApplicationDisclosedquerybool?NoFilter the results to those where the application has been disclosed (true), or not (false), or either (null)
SubUserNamequerystringNoIf the searches are being accessed by a sub user, specify their username here to only return searches they have permissions to view
PagedRequest Parameters:
NameParameterData TypeRequiredDescription
PageLimitqueryintNoThe maximum number of records to be returned in one page
PageOffsetqueryintNoThe starting point in the list of records from where the data should be fetched. Zero based index.
SortquerystringNoThe term to determine the order in which the data is 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
ApiUserKeyheader, bodystringYesThe API User Key provided by us when you signed up to use our API
GetDbsSearchesResponse Parameters:
NameParameterData TypeRequiredDescription
DataformGetDbsSearchesDataNo
GetDbsSearchesData Parameters:
NameParameterData TypeRequiredDescription
SearchesformArrayOfDbsSearchShortNo
PagedResponse<T> Parameters:
NameParameterData TypeRequiredDescription
MetaformMeta<T>NoThe response Metadata
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
Meta<T> Parameters:
NameParameterData TypeRequiredDescription
LinksformMetaLinksNoPagination links
TotalCountformint?NoThe total number of records for the query
PageLimitformint?NoThe maximum number of records to be returned in one page
PageOffsetformint?NoThe starting point in the list of records from where the data should be fetched. Zero based index.
MetaLinks Parameters:
NameParameterData TypeRequiredDescription
FirstformstringNoThe link to the first page of records
LastformstringNoThe link to the last page of records
NextformstringNoThe link to the next page of records, if applicable
PrevformstringNoThe link to the last page of records, if applicable
Links Parameters:
NameParameterData TypeRequiredDescription
SelfformstringNo
DbsSearchShort Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
DateSearchedformDateTimeNo
DateUpdatedformDateTimeNo
StatusformstringNo
DisclosureStatusformstringNo
IsApplicantInfoCompletedformboolNo
IsIdCheckCompletedformboolNo
IsApplicationCompletedformboolNo
IsApplicationSubmittedformboolNo
IsApplicationDisclosedformboolNo
DisclosureLevelformstringNo
NameformstringNo
ReferenceformstringNo

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 HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"data":{"searches":[{"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","name":"String","reference":"String"}],"meta":{"links":{"first":"String","last":"String","next":"String","prev":"String","self":"String"},"totalCount":0,"pageLimit":0,"pageOffset":0},"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}}