LogoLogo
  • Welcome!
  • GETTING STARTED
    • Signing Up
    • Choose a Product
    • Choose an Integration Option
    • Run Your First Test Job
    • Complete Your KYC
    • Fund Your Wallet
    • Go Live!
    • Pricing
  • SUPPORTED ID TYPES & DOCUMENTS
    • For Individuals (KYC)
      • Using ID Number
        • Supported Countries
          • Côte d'Ivoire
            • National ID (without Photo)
            • Resident ID (without Photo)
          • Ghana
            • Ghana Card
            • Ghana Card (without Photo)
            • Passport
            • Voter's ID
          • Kenya
            • Alien Card
            • KRA Pin
            • National ID
            • National ID (without Photo)
            • Passport
            • Tax Information
          • Nigeria
            • Bank Account
            • BVN
            • NIN V2
            • NIN Slip Verification
            • V_NIN (Virtual NIN)
            • Phone Number
            • Voter's ID
          • South Africa
            • National ID
            • National ID (without Photo)
            • Phone Number
            • Refugee and Asylum ID
          • Uganda
            • National ID (without Photo)
            • Basic KYC in Uganda
          • Zambia
            • Bank Account
            • TPIN
          • Zimbabwe
            • National ID (without Photo)
        • Test Data
          • Customising Sandbox Test Data
        • ID Number Regex
        • Visual Samples of Supported ID Types
      • Using Document Image
        • Continents
          • Africa
          • Asia and the Middle East
          • Europe
          • North America
          • Oceania
          • South America
    • For Businesses (KYB)
      • Supported Countries
        • Nigeria
          • Business Registration
          • Tax Information
        • Kenya
          • Business Registration
        • South Africa
          • Business Registration
      • ID Number Regex
  • PRODUCTS
    • For Individuals (KYC)
      • AML Check
        • AML News Media
      • Basic KYC
      • Biometric KYC
      • Digital Address Verification
      • Document Verification
        • Document Verification
        • Enhanced Document Verification
      • Electronic Signature
      • Enhanced KYC
      • Phone Number Verification
      • SmartSelfie™ Authentication
      • SmartSelfie™ Compare
      • Smile Secure
    • For Businesses (KYB)
      • Business Verification
  • Integration Options
    • Mobile
      • Getting Started
      • Products
        • Biometric KYC
        • BVN Consent
        • Document Verification
        • Enhanced Document Verification
        • Enhanced KYC
        • SmartSelfie™ Enrollment and Authentication
        • Enhanced SmartSelfie™ Enrollment And Authentication
      • Customization
        • UI Components
      • Offline Mode
      • Release Notes
        • Android Release Notes
        • iOS Release Notes
        • Flutter Release Notes
        • React Native Release Notes
    • No-Code
      • Smile Links
        • Link FAQs
        • Rest API
    • Server to Server
      • Ruby
        • Installation
        • Signature
        • Products
          • Basic KYC
          • Enhanced KYC
          • Biometric KYC
          • Document Verification
          • SmartSelfie™ Authentication
          • KYB - Business Verification
          • AML Check
        • Generate Token for Web Integration
        • Utilities
      • Python
        • Installation
        • Signature
        • Products
          • Basic KYC
          • Enhanced KYC
          • Biometric KYC
          • Document Verification
          • SmartSelfie™ Authentication
          • Business Verification
        • Generate Token for Web Integration
        • Utilities
      • Java
        • Release Notes
        • Installation
        • Signature
        • Products
          • Basic KYC
          • Enhanced KYC
          • Biometric KYC
          • Document Verification
          • SmartSelfie™ Authentication
        • Generate Token for Web Integration
        • Utilities
      • Node.js
        • Installation
        • Signature
        • Products
          • Basic KYC
          • Enhanced KYC
          • Biometric KYC
          • Document Verification
          • Enhanced Document Verification
          • SmartSelfie™ Authentication
          • Business Verification
        • Generate Token for Web Integration
        • Utilities
      • PHP
        • Installation
        • Signature
        • Products
          • Basic KYC
          • Enhanced KYC
          • Biometric KYC
          • Document Verification
          • SmartSelfie™ Authentication
        • Generate Token for Web Integration
        • Utilities
    • Rest API
      • Signing your API Request
        • Using Signature
      • Products
      • Postman Collection
      • Utilities
    • Web / Mobile Web
      • Web Integration
        • Installation
        • Usage
        • End User Consent
        • Support
      • Javascript SDK
        • Installation
        • Usage
        • Migration
        • Deprecated Version
          • Installation
          • Usage
          • Notes
          • Support
  • FURTHER READING
    • FAQs
      • What are your support hours?
      • How do I set up a callback?
      • How to re-enroll, deactivate or delete a user?
      • Add or remove team members
      • What are top-level keys?
      • What are partner_params?
      • How do job types map to the new product names?
      • Is there an API I can use to monitor my wallet balance?
      • Is there an API I can query to check the availability status of an ID type?
      • How do I integrate Smile ID in other countries or query other ID types?
      • What are the image types I can upload to Smile ID?
      • Why aren't Kenyan IDs returning images for some IDs queried?
      • Why are some of my bank verification requests returning 'ID authority unavailable'?
      • How can I look up a specific user's data?
      • Selfie best-practices
      • Document capture best-practices
      • What happens under the hood?
      • Guide to the user consent screen
      • What is code 2302?
      • Using the Demo App and Scanning QR codes
    • Job status
    • KYC receipts
    • Result codes
      • Error codes
    • Securing your account with two-factor authentication (2FA)
    • Security Overview
    • Troubleshooting
      • Troubleshooting error 2204 & 2205 - "You're not authorized to do that"
      • Why is my Web API job taking so long?
      • Image capture issues on web client
Powered by GitBook
On this page
  • Integration Options
  • Endpoint
  • Request Values
  • Example JSON Body
  • Return Values
  • Example JSON Response
  • Error Codes
  • Result Codes and Result Texts

Was this helpful?

  1. PRODUCTS
  2. For Individuals (KYC)
  3. AML Check

AML News Media

PreviousAML CheckNextBasic KYC

Last updated 2 months ago

Was this helpful?

Our mass media screening feature identifies negative news articles and events associated with the named entity. The News Media indicator highlights articles where the entity’s name is found, matched to specific tags such as Financial Crime, Arms Trafficking, Narcotics, Human Rights Violations, Violent Crime, Terrorism, Sexual Crime, and Other Crimes.

Integration Options

Currently only available via the .

Endpoint

Request type: POST

Environment
Endpoint

Sandbox

https://testapi.smileidentity.com/v1/aml/news

Production

https://api.smileidentity.com/v1/aml/news

Request Values

AML News requires the following input parameters which should be contained in a JSON body object submitted to the endpoint

Name

Type

Required

Description

partner_id

string

Yes

signature

string

Yes

timestamp

string

Yes

The timestamp used to calculate the signature in ISO date/time format

user_id

string

Yes

A value generated by you previously used for the AML Check.

job_id

string

Yes

The SmileJobID returned in the AML Check.

ref

string

Yes

The ref related to the found person returned after an AML Check

news_category

string

Yes

The specific category to view. This is returned in the news_summary indicator.

page

integer

No

The specific page number you want to visit. If you do not enter any number, you get the first page.

limit

integer

No

The total articles to return per page.

Example JSON Body

{
  "job_id": "3ba0e15e-1a56-4799-a94d-b0e084f50256",
  "partner_id": "023",
  "signature": "...",
  "ref": "...",
  "timestamp": "2021-08-12T17:57:00.614879",
  "user_id": "4cb0f26-2b567-5800-b05e-c0f095g6036",
  "news_category": "financial_crime"
  "page": 1,
  "limit": 25
}

Return Values

AML News returns related news media of the customer.

Name

Type

Description

Return Values

news

array of objects

A list of the news media

news[].title

string

The news heading

news[].body

string

A summary of the news

news[].publisher

string

The publisher of the news

news[].published_date

string

The date the news was published

news[].publisher_country_code

string

The ISO country code of the publisher when available

news[].url

string

A link to the news publication

meta

object

An object containing page details

meta.currentPage

integer

The current page

meta.limit

integer

The page size provided

meta.totalCount

integer

The total items available

Example JSON Response

{
  "news": [
    {
      "title": "title",
      "body": "body",
      "publisher": "publisher",
      "published_date": "2021-07-01T00:00:00Z",
      "publisher_country_code": "KE",
      "url": "https://example.com"
    }
  ],
  "meta": {
    "currentPage": 1,
    "limit": 25,
    "totalCount": 1
  }
}

Error Codes

Error codes occur when there is a general failure that prevents the system from processing the job.\

Code

Text

Description

2205

You are not authorized to do that.

2210

No enrolled user found

You attempted to re-use KYC from a previous Biometric KYC or Document Verification job but the user id was not found in the system. Check the user id and try resubmiting the request

2401

System Error

2403

Invalid JSON

The JSON is wrongly formatted or has an invalid structure

2413

<key> is required

The required key <key> is missing in the request body. Add the key and run the request again.

Result Codes and Result Texts

AML check jobs that are processed successfully can have the following result codes

A unique number assigned by Smile ID to your account. Can be found in the portal

The outgoing signature to authenticate the request from you to Smile ID. You can read more about calculating the signature

An invalid signature/timestamp was used to sign the request. You can troubleshoot the error .

Rest API
here
here
here