Sanctions Search API: v2

GetCompanyLookups

CompanyLookup

The following routes are available for this service:
POST	/companylookups/list	Get all company lookups

**GetCompanyLookups** Parameters:
Name	Parameter	Data Type	Required	Description
Request	body	GetCompanyLookupsRequest	No

**BaseRequest** Parameters:
Name	Parameter	Data Type	Required	Description
Authentication	header, body	Authentication	Yes	The authentication credentials

**Authentication** Parameters:
Name	Parameter	Data Type	Required	Description
ApiUserId	header, body	string	Yes	The 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)
ApiUserKey	header, body	string	Yes	The 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)
UserId	header, body	string	No	The 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).

**GetCompanyLookupsRequest** Parameters:
Name	Parameter	Data Type	Required	Description
SubUserName	form	string	No	If the searches are being accessed by a sub user, specify their username here to only return searches they have permissions to view
ListIncompleteSearches	form	bool	No
Page	form	int	No
SortOrder	form	string	No
NameSearch	form	string	No
FilterIsUpdateRequired	form	bool?	No	Filter the results to show only records that require updates due to company changes detected by CompanyLookup monitor
FilterReference	form	string	No
FilterDateFrom	form	DateTime?	No
FilterDateTo	form	DateTime?	No
FilterUserName	form	string	No	If set, will only return searches created by the user

**GetCompanyLookupsResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Data	form	GetCompanyLookupsData	No

**GetCompanyLookupsData** Parameters:
Name	Parameter	Data Type	Required
TotalRecords	form	int	No
CurrentPageNum	form	int	No
MaxPageNum	form	int	No
CompanyLookupRecords	form	ArrayOfCompanyLookupListItem	No

**BaseResponse** Parameters:
Name	Parameter	Data Type	Required	Description
ResponseStatus	form	ResponseStatus	No	The status of the response

**ResponseStatus** Parameters:
Name	Parameter	Data Type	Required
ErrorCode	form	string	No
Message	form	string	No
StackTrace	form	string	No
Errors	form	ArrayOfResponseError	No
Meta	form	Dictionary<string, string>	No

**ResponseError** Parameters:
Name	Parameter	Data Type	Required
ErrorCode	form	string	No
FieldName	form	string	No
Message	form	string	No
Meta	form	Dictionary<string, string>	No

**CompanyLookupListItem** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
SearchCriteria	form	SearchCriteria	No
SelectedLists	form	ArrayOfLists	No
Date	form	DateTime	No
HasCompanyId	form	bool	No
HasCompanyDetails	form	bool	No
HasStartedSearches	form	bool	No
HasCompletedSearches	form	bool	No
CountNewCompanyChanges	form	int?	No

**SearchCriteria** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	No
Address	form	string	No
Country	form	string	No
DateOfBirth	form	string	No
Nationality	form	string	No
Reference	form	string	No

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.

POST /companylookups/list HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"request":{"subUserName":"String","listIncompleteSearches":false,"page":0,"sortOrder":"String","nameSearch":"String","filterIsUpdateRequired":false,"filterReference":"String","filterDateFrom":"\/Date(-62135596800000-0000)\/","filterDateTo":"\/Date(-62135596800000-0000)\/","filterUserName":"String"},"authentication":{"apiUserId":"String","apiUserKey":"String","userId":"String"}}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"data":{"totalRecords":0,"currentPageNum":0,"maxPageNum":0,"companyLookupRecords":[{"id":0,"searchCriteria":{"name":"String","address":"String","country":"String","dateOfBirth":"String","nationality":"String","reference":"String"},"selectedLists":["String"],"date":"\/Date(-62135596800000-0000)\/","hasCompanyId":false,"hasCompanyDetails":false,"hasStartedSearches":false,"hasCompletedSearches":false,"countNewCompanyChanges":0}],"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}}