Public Repository

Last pushed: 5 months ago
Short Description
Riskslists API server image
Full Description

Risklists API

Various risk lists and related search functionality implemented in R and exposed via REST API courtesy of OpenCPU.

Currently implemented risk lists include:

  • OSFI compliance lists: see here for further list details
  • RCMP wanted lists: see here for further list details
  • FINTRAC administrative monetary penalties database: see here for further details

Current release

3.0 (2017-03-31)

List versions

  • OSFI compliance lists: last updated 2017-03-31
  • RCMP wanted lists: last updated 2017-03-31
  • FINTRAC administrative monetary penalties database: last updated 2017-03-31

Running the image

Starting the container daemonized:

sudo docker run -t -d -p 80:80 -p 8004:8004 br00t/risklists:v3

Starting the container with interactive shell (debug):

sudo docker run -t -i -p 80:80 -p 8004:8004 br00t/risklists:v3 sh -c 'service opencpu restart && /bin/bash'

By default, the base OpenCPU appliance exposes http via ports 80 and 8004. Please note that
you should not redirect these ports as this will break http functionality and the REST API
will not work properly!

API usage

You must send application/json encoded POST requests to all endpoints.

Base URL:

http://xxx.xxx.xxx.xxx:80/ocpu/library/risklists/R/

or

http://xxx.xxx.xxx.xxx:8004/ocpu/library/risklists/R/

OSFI API Endpoints

OSFICheckEntityName

See if your name matches any entities listed in OSFI compliance lists

Parameters

  • entity_name

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFICheckEntityName/json/ -H 'Content-Type: application/json' -d '{"entity_name":"al shabbaab"}'
{
  "query": ["AL SHABBAAB"],
  "results": [
    {
      "entity.name": "AL SHABAAB",
      "id": "181.000000",
      "date.of.designation.and.basis": "CC (MARCH 5, 2010)"
    }
  ]
}

OSFICheckEntityNames

See if a user-supplied name matches any entities listed in OSFI compliance lists

Parameters

  • entity_names

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFICheckEntityNames/json/ -H 'Content-Type: application/json' -d '{"entity_names":["al shabbaab", "al qeda"]}'
[
  {
    "query": ["AL SHABBAAB"],
    "results": [
      {
        "entity.name": "AL SHABAAB",
        "id": "181.000000",
        "date.of.designation.and.basis": "CC (MARCH 5, 2010)"
      }
    ]
  },
  {
    "query": ["AL QEDA"],
    "results": [
      {
        "entity.name": "AL QAEDA",
        "id": "26.030000",
        "date.of.designation.and.basis": "UNSC (OCTOBER 6, 2001); UNSC (MARCH 5, 2009); UNSC (MARCH 20, 2012)"
      }
    ]
  }
]

OSFICheckFullName

See if a user-supplied name matches any full name listed in OSFI compliance lists

Parameters

  • full_name

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFICheckFullName/json/ -H 'Content-Type: application/json' -d '{"full_name":"abdulla raqib"}'
{
  "query": ["ABDULLA RAQIB"],
  "results": [
    {
      "first.name": "ABDULLAH",
      "last.name": "RAGAB",
      "dob": "1963",
      "nationality": "LIBYAN",
      "id": "396.02",
      "address.and.other.info": "Passport no.: Libyan passport 1990/345751, Libyan passport number 1990/345751; Address: Bab Ben Ghasheer, Tripoli, Libyan Arab Jamahiriya; National Identification No.: Libyan national identification number 220334; Other information: Mother’s name is Kalthoum Abdul Salam al-Shaftari. Senior member of Libyan Islamic Fighting Group and member of Al-Qaida."
    }
  ]
}

OSFICheckFullNames

See if any of a list of user-supplied names matches any full names listed in OSFI compliance lists

Parameters

  • full_names

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFICheckFullNames/json/ -H 'Content-Type: application/json' -d '{"full_names":["abdulla raqib", "noor qasim"]}'
[
  {
    "query": ["ABDULLA RAQIB"],
    "results": [
      {
        "first.name": "ABDULLAH",
        "last.name": "RAGAB",
        "dob": "1963",
        "nationality": "LIBYAN",
        "id": "396.02",
        "address.and.other.info": "Passport no.: Libyan passport 1990/345751, Libyan passport number 1990/345751; Address: Bab Ben Ghasheer, Tripoli, Libyan Arab Jamahiriya; National Identification No.: Libyan national identification number 220334; Other information: Mother’s name is Kalthoum Abdul Salam al-Shaftari. Senior member of Libyan Islamic Fighting Group and member of Al-Qaida."
      }
    ]
  },
  {
    "query": ["NOOR QASIM"],
    "results": [null]
  }
]

OSFICheckLastName

See if a user-supplied name matches any last name listed in OSFI compliance lists (quicker than full name check)

Parameters

  • last_name

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFICheckLastName/json/ -H 'Content-Type: application/json' -d '{"last_name":"dada"}'
{
  "query": ["DADA"],
  "results": [
    {
      "first.name": "AHMAD",
      "last.name": "ZADA",
      "dob": "1966-1967",
      "nationality": "AFGHAN",
      "id": "107.02",
      "address.and.other.info": "Title: Maulavi, Mullah; Designation: Governor of Zabol and Uruzgan Provinces under the Taliban regime; Other Information: Taliban member responsible for Uruzgan Province, Afghanistan, as at early 2007. Brother-in-law of Mullah Mohammed Omar. Believed to be in Afghanistan/Pakistan border area."
    }
  ]
}

OSFICheckLastNames

See if any of a list of user-supplied names matches any last names listed in OSFI compliance lists (quicker than full name check)

Parameters

  • last_names

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFICheckLastNames/json/ -H 'Content-Type: application/json' -d '{"last_names":["dada", "kim"]}'
{
  "query": ["AL SHABBAAB"],
  "results": [
    {
      "entity.name": "AL SHABAAB",
      "id": "181.000000",
      "date.of.designation.and.basis": "CC (MARCH 5, 2010)"
    }
  ]
}

OSFIGetLastUpdate

Get list of known updates to the OSFI lists (sanctions and terrorist lists)

Parameters

  • none

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/OSFIGetLastUpdate/json/ -H 'Content-Type: application/json'
[
  {
    "date": "2017-03-31",
    "notice": "Changes to UNAQTR Consolidated List",
    "type": "TERRORIST.LISTS"
  },
  {
    "date": "2014-03-05",
    "notice": "The Freezing Assets of Corrupt Foreign Officials Act, Freezing Assets of Corrupt Foreign Officials (Ukraine) Regulations",
    "type": "SANCTIONS.LISTS"
  }
]

FINTRAC API Endpoints

FINTRACGetAdministrativeMonetaryPenalties

Get FINTRAC database of published administrative monetary penalties

Parameters:

  • none

CURL Example:

curl -X POST http://localhost/ocpu/library/risklists/R/FINTRACGetAdministrativeMonetaryPenalties/json/ -H 'Content-Type: application/json'
[
  {
    "date": "2016-05-11",
    "name": "Howell Investment Management Inc.",
    "entity.type": "securities dealer",
    "city": "Etobicoke",
    "region": "Ontario",
    "penalty.amount": 13500,
    "details": "http://www.fintrac-canafe.gc.ca/pen/4-eng.asp?m=41",
    "violations": 3,
    "violation.1": "failure of a person or entity to develop and apply written compliance policies and procedures that are kept up to date and in the case of an entity are approved by a senior officer which is contrary to paragraph 9.6(1) of the proceeds of crime (money laundering) and terrorist financing act and paragraph 71(1)(b) of the proceeds of crime (money laundering) and terrorist financing regulations.",
    "violation.2": "failure of a person or entity to assess and document the risk referred to in paragraph 9.6(2) of the act taking into consideration prescribed factors which is contrary to paragraph 9.6(1) of the proceeds of crime (money laundering) and terrorist financing act and paragraph 71(1)(c) of the proceeds of crime (money laundering) and terrorist financing regulations.",
    "violation.3": "failure of a person or entity that has employees agents or other persons authorized to act on their behalf to develop and maintain a written ongoing compliance training program for those employees agents or persons which is contrary to paragraph 9.6(1) of the proceeds of crime (money laundering) and terrorist financing act and paragraph 71(1)(d) of the proceeds of crime (money laundering) and terrorist financing regulations."
  }, ...
]

RCMP API Endpoints

RCMPGetWantedList

Obtain most recent version of the RCMP wanted list

Parameters

  • none

CURL Example

curl -X POST http://localhost/ocpu/library/risklists/R/RCMPGetWantedList/json/ -H 'Content-Type:  application/json'
[
  {
    "name": "Michael Teddy Gibson",
    "charges": "First Degree Murder",
    "charges.2": "Wanted on Canada-wide warrant for first degree murder.",
    "description": "On the evening of April 2, 2016, Michael Gibson shot Julian Weekes outside a Toronto bar. Weekes fled but was found shortly afterwards deceased in a parking lot. Through blood trail evidence and analysis of the area's surveillance video, investigators were able to identify Gibson and issued a warrant for his arrest.",
    "sex": "Male",
    "born": "October 1986",
    "place.of.birth": "Ontario",
    "hair.colour": "Black",
    "eye.colour": "Brown",
    "weight": "166 lbs / 75 kg",
    "height": "5 ft 07 in / 170 cm",
    "scars": "Buttocks from gunshot wound"
  }, ...
]
Docker Pull Command
Owner
br00t

Comments (0)