Methods

Follow

All of the methods of our 2nd generation web service take user credentials as the first parameter. This should help to:

  1. Make it clearer that authentication is required
  2. Make it easier to use across all frameworks and languages

The process of accessing these is pretty much the same in all systems:

  1. Create the object for the service
  2. Create the object for the credentials
  3. Create any additional objects required to call the method of your choice
  4. Submit the objects and other parameters to the service
  5. Process the results

There are some code samples (below) for popular frameworks to assist you with integration.

Details about each method:

AddDynamicScreeningListEntry

This method is for our customers who utilize the Dynamic Screening List (DSL). In addition to the entry form available from the website, you can use this method and integrate population of your list straight out of your ERP or Accounting system. If you would like to check for the existance of an entry on your DSL you can use the GetDynamicScreeningListEntry method.

Definition

public int (bool in v2.0) AddDynamicScreeningListEntry( 
   DPLv2Credentials credentials,
   DPLv2DuplicateHandlingType type, // added in v2.1
   string Name, 
   string Street1, 
   string Street2, 
   string City, 
   string Region, 
   string ISO2LetterCountryCode, 
   string UserDefinedCode, 
   string Notes,
   int clientSuppliedId // added in v2.1
);

Notes

Signature changed in v 2.1, changes noted above.

All country codes used by MKDS are ISO 2 letter country codes. You can review our current list on the mkdenial.com website.

ClearMatch

ClearMatch should be used only by our clients who use the match clearance system. This is a system to be used in conjunction with our batch screening where one can mark a reported match as "cleared" and it will not be reported in the future. Your report should have links to allow you to do this from the website, but if you wish to integrate this into a larger system, we have provided this simple interface:

Definition

public bool ClearMatch( 
DPLv2Credentials credentials, 
int idnum, 
string partyName, 
string signature
);

Notes

If you are interested in the match clearance system contact us for a quote.

GetAliases

Each entry on our denied party list may have additional aliases or be an alias of another entry on the list. This method takes an entries unique ID (IDNUM) and returns any aliases we have in the system. If the entry has no aliases and isn't an alias it will return an empty list.

Definition

public List<DPLv2Entry> GetAliases( 
DPLv2Credentials credentials, 
int IDNUM);

Notes

If you request aliases for an IDNUM that isn't valid you will also receive a null list.

GetCodeDetails

Our DPL entries are all related to source lists which we represent as a "Code", this method will allow you to pull back additional details about that code like the full name and the country of origin.

Definition

public code GetCodeDetails( 
DPLv2Credentials credentials, 
string listCode 
);

Notes

An invalid code will return a null result.

GetCountryDetails

We use ISO 2 letter codes for our countries, but if you need additional information about a country, like the full name, you can use this method.

Definition

public country GetCountryDetails( 
DPLv2Credentials credentials, 
string countryCode 
);

Notes

And invalid country request will receive a null result.

GetDynamicScreeningListEntry

This method is for our customers who utilize the Dynamic Screening List (DSL). In addition to the admin system on the website, you can use this method and integrate population of your list straight out of your ERP or Accounting system. If you would like to add an item to your existing list you can use the AddDynamicScreeningListEntry method.

Definition

public DynamicScreeningEntity[] GetDynamicScreeningListEntry(
    DPLv2Credentials credentials,
    int id,
    bool idIsCustomers // added in v 2.1
);

Notes

Signature changed in v 2.1, changes noted above.

If you are interested in the DSL system, contact us for a quote.

The "idIsCustomers" boolean controls the value expected in id. If the id was previously supplied by you, you can address that same id when doing an update. If, however, you saved the id returned upon adding, and you are using that to reference your entity, you should set idIsCustomers to false.

GetEntry

If you have an IDNUM and no further details, or limited details, you can use this method to pull back the entire DPL record.

Definition

public DPLv2Entry GetEntry( 
DPLv2Credentials credentials, 
int idnum 
);

Notes

An invalid IDNUM will return a null result.

GetUserDetails

This method returns the details of the user account used in the credentials. You can use this to confirm that you are using the correct account by reviewing the details, it can also be used to determine what permissions that account has on the website.

Definition

public DPLv2User GetUserDetails( 
DPLv2Credentials credentials 
);

Notes

DPLv2User.WebService will always be true or you wouldn't have been able to make the request for the information.

IsCountryEmbargoed

There are a few countries that are straight out embargoed. These are special cases that are not addressed by the SearchDpl method, and if you do not have a system that already checks for embargoed countries we recommend using this method to ensure you are compliant.

Definition

public bool IsCountryEmbargoed( 
DPLv2Credentials credentials, 
string iso2Letter 
);

Notes

The country code MUST be an ISO 2 letter code or this method will not return the expected results.

LastUpdate

This method will return the date of the last update to the most recently updated (or added) entry in our DPL. You can use this method to trigger other events that only need to happen when we update the list like download a data export.

Definition

public DateTime LastUpdate( 
DPLv2Credentials credentials 
);

Notes

This data is updated live so if we are in the middle of an update it will change multiple times, if you are going to use this as suggested above, don't check it until after 8PM EST/EDT to ensure that all updates for the day are done.

LicenseRequired

Is a license required to export your goods? Given a proper ECCN and ISO 2 letter country code, this method will tell you whether a license is required and any additional details that you need to be concerned with.

Definition

public LinceseRequiredResult LicenseRequired( 
DPLv2Credentials credentials, 
string eccnCode, 
string iso2Country 
);

Notes

The ISO 2 Country code must be a valid code or this method will return unintended results.

SearchDpl

The cornerstone of our web service and the main method that you will be concerned with, this allows you to search our list in a manner similar to that of the website. The search request object is rather complex and will allow you to construct queries that go well above what is possible from the website. Please review our code samples to get yourself familiar with some common search request queries.

Your search will be limited to a maximum of 50 match constructs across all groups and no more than 5 matches can reference the NAME or STREET fields. This should be more than sufficient for your needs, but helps us to restrict the use to single transactions, if you are in need of large batch transactions, please consider our bulk screening product, or implement your batch screening one name at a time.

Each search is charged at least 1 transaction with a minimum of 1 per name or street screened. The rate for that transaction is in your contract.

Definition

public DPLv2Report SearchDpl( 
DPLv2Credentials credentials, 
Search request 
);

Notes

If you find that the search results are consistantly slower that you would like, and your query object is very involved, it is possible that simplification will greatly optimize your request. Multiple calls to the service for one transaction in your database is not unheard of.

If your results would return more than 1,000 hits only the first 1,000 will be returned.

Searches on the field "country" are restricted to the "Phrase" scope since they are two letter codes. If you do choose a "Word" scope the system will rewrite the search for you.

UpdateDynamicScreeningListEntry

This method is for our customers who utilize the Dynamic Screening List (DSL). In addition to the entry form available from the website, you can use this method and update your list straight out of your ERP or Accounting system. If you would like to check for the existance of an entry on your DSL you can use the GetDynamicScreeningListEntry method.

Definition

public bool UpdateDynamicScreeningListEntry( 
DPLv2Credentials credentials,
int id,
bool idIsCustomers,
string Name, 
string Street1, 
string Street2, 
string City, 
string Region, 
string ISO2LetterCountryCode, 
string UserDefinedCode, 
string Notes 
);

Notes

Added in version 2.1

All country codes used by MKDS are ISO 2 letter country codes. You can review our current list on the mkdenial.com website. The "idIsCustomers" boolean controls the value expected in id. If the id was previously supplied by you, you can address that same id when doing an update. If, however, you saved the id returned upon adding, and you are using that to reference your entity, you should set idIsCustomers to false.

Have more questions? Submit a request

Comments

Powered by Zendesk