Company check

This service checks whether a company has an AML risk, and if it has any identified hits and other information on the company. Use AML API for detailed API request reference.

Pricing

Please contact iDenfy's sales team sales@idenfy.com for a detailed price-sheet.

Webhook data

The service check returns company's data in JSON format. Overall response can be seen in the table below:

Overall response table

JSON key	Type	Explanation
status	Object	The overall status of the service check.
data	List	Data returned from services.
serviceName	String	The name of the service that was used to check a company.
serviceGroupType	String	The type of the service that was used. It is always COMPANY.
uid	String	A unique identifier for a request. NOTE that it is unique only in one request scope. It is not unique globally. This parameter is only useful when doing multi-company checks.
errorMessage	String	In case of an error in the checking process a human readable error message is given.

Status table

JSON key	Type	Explanation
serviceSuspected	Bool	Indicates whether a service found a record about the company under check.
checkSuccessful	Bool	Indicated whether an error occurred while doing a check.
serviceFound	Bool	Indicates whether a service was found for a given country.
serviceUsed	Bool	Indicated whether a service was used.
overallStatus	String	A mapping string indicating overall status of the check. Possible values: DATA_ERROR Supplied data for fraud check is malformed therefore a check can not be performed SUSPECTED Fraud API results were found for given person therefore check is suspected NOT_SUSPECTED Fraud API results were not found therefore the check is not suspected INTERNAL_ERROR Internal error on our side SERVICE_NOT_FOUND Could not find a suitable fraud API for supplied data CHECK_FAILED The called API did not return a successful response or response was malformed

Example request

{
  "mode": "DATA",
  "services": [
    "COMPANY"
  ],
  "data": [
    {
      "companyName": "MY AVIATION COMPANY LIMITED",
      "country": "LT",
      "negativeNews": false,
      "nameCheck": true
    }
  ]
}

Example response

{
  "COMPANY": [
    {
      "status": {
        "serviceSuspected": true,
        "serviceUsed": true,
        "serviceFound": true,
        "checkSuccessful": true,
        "overallStatus": "SUSPECTED"
      },
      "serviceName": "CompanyCheck",
      "uid": "UGT3GAQZHGX5DL3PTYU685E0Y",
      "errorMessage": null,
      "data": [
        {
          "Name": "MY AVIATION COMPANY LIMITED",
          "Residence": "LT",
          "CompanyHasHits": true,
          "ScoreAml": null,
          "RiskAml": "M",
          "RiskElements": [
            {
              "RiskName": "CompanyHasHits",
              "Explanation": "The company's name is similar to names on sanctions' lists. Please check if the hits apply to the company."
            },
            {
              "Explanation": "The AML risk for this company is MEDIUM",
              "RiskName": "RiskAml"
            }
          ],
          "HitsOnLists": [
            {
              "QueryId": 0,
              "ListNumber": 24877,
              "Name": "MY AVIATION COMPANY LIMITED",
              "IsPerson": false,
              "Reason": "IFSR Program",
              "ListName": "OFAC",
              "LinkedDocument": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=24877",
              "OtherInformation": "",
              "LastUpdateDate": "2018-09-18T00:00:00",
              "Nationality": "Unknown",
              "SimplifiedName": "MY AVIATION COMPANY",
              "HitType": "Sanction",
              "IsActive": true,
              "Score": 100
            }
          ],
          "CompaniesFound": []
        }
      ],
      "serviceGroupType": "COMPANY"
    }
  ]
}