> For the complete documentation index, see [llms.txt](https://legacy-docs.usesmileid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://legacy-docs.usesmileid.com/products/for-individuals-kyc/aml-check/aml-news.md).

# AML News Media

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 [Rest API](/integration-options/rest-api.md).

## Endpoint

Request type: POST

<table><thead><tr><th width="211.92523193359375">Environment</th><th>Endpoint</th></tr></thead><tbody><tr><td>Sandbox</td><td>https://testapi.smileidentity.com/v1/aml/news</td></tr><tr><td>Production</td><td>https://api.smileidentity.com/v1/aml/news</td></tr></tbody></table>

## Request Values

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

<table data-header-hidden><thead><tr><th width="268.3974609375"></th><th width="115"></th><th width="108"></th><th></th></tr></thead><tbody><tr><td><strong>Name</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td></tr><tr><td>partner_id</td><td>string</td><td>Yes</td><td>A unique number assigned by Smile ID to your account. Can be found in the portal<a href="https://portal.usesmileid.com/api-key"> here</a></td></tr><tr><td>signature</td><td>string</td><td>Yes</td><td>The outgoing signature to authenticate the request from you to Smile ID. You can read more about calculating the signature <a href="https://docs.usesmileid.com/integration-options/rest-api/signing-your-api-request/generate-signature">here</a></td></tr><tr><td>timestamp</td><td>string</td><td>Yes</td><td>The timestamp used to calculate the signature in ISO date/time format</td></tr><tr><td>user_id</td><td>string</td><td>Yes</td><td>A value generated by you previously used for the AML Check.<br></td></tr><tr><td>job_id</td><td>string</td><td>Yes</td><td>The <code>SmileJobID</code> returned in the AML Check.</td></tr><tr><td>ref</td><td>string</td><td>Yes</td><td>The <code>ref</code> related to the found person returned after an AML Check</td></tr><tr><td>news_category</td><td>string</td><td>Yes</td><td>The specific category to view. This is returned in the <code>news_summary</code> indicator.</td></tr><tr><td>page</td><td>integer</td><td>No</td><td>The specific page number you want to visit. If you do not enter any number, you get the first page.</td></tr><tr><td>limit</td><td>integer</td><td>No</td><td>The total articles to return per page.</td></tr></tbody></table>

### Example JSON Body

```json
{
  "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.

<table data-header-hidden><thead><tr><th width="231"></th><th width="140"></th><th width="198"></th><th></th></tr></thead><tbody><tr><td><strong>Name</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td><td><strong>Return Values</strong></td></tr><tr><td>news</td><td>array of objects</td><td>A list of the news media</td><td><br></td></tr><tr><td>news[].title</td><td>string</td><td>The news heading</td><td><br></td></tr><tr><td>news[].body</td><td>string</td><td>A summary of the news</td><td><br></td></tr><tr><td>news[].publisher</td><td>string</td><td>The publisher of the news</td><td><br></td></tr><tr><td>news[].published_date</td><td>string</td><td>The date the news was published</td><td><br></td></tr><tr><td>news[].publisher_country_code</td><td>string</td><td>The ISO country code of the publisher when available</td><td><br></td></tr><tr><td>news[].url</td><td>string</td><td>A link to the news publication</td><td><br></td></tr><tr><td>meta</td><td>object</td><td>An object containing page details</td><td><br></td></tr><tr><td>meta.currentPage</td><td>integer</td><td>The current page</td><td><br></td></tr><tr><td>meta.limit</td><td>integer</td><td>The page size provided</td><td><br></td></tr><tr><td>meta.totalCount</td><td>integer</td><td>The total items available</td><td><br></td></tr></tbody></table>

### Example JSON Response

```json
{
  "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.\\

<table data-header-hidden><thead><tr><th width="144.33333333333331"></th><th width="247"></th><th></th></tr></thead><tbody><tr><td><strong>Code</strong></td><td><strong>Text</strong></td><td><strong>Description</strong></td></tr><tr><td>2205</td><td>You are not authorized to do that.</td><td>An invalid signature/timestamp was used to sign the request. You can troubleshoot the error <a href="https://docs.usesmileid.com/further-reading/troubleshooting/troubleshooting-error-2204-and-2205-youre-not-authorized-to-do-that">here</a>.</td></tr><tr><td>2210</td><td>No enrolled user found</td><td>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</td></tr><tr><td>2401</td><td>System Error</td><td><br></td></tr><tr><td>2403</td><td>Invalid JSON</td><td>The JSON is wrongly formatted or has an invalid structure</td></tr><tr><td>2413</td><td>&#x3C;key> is required</td><td>The required key &#x3C;key> is missing in the request body. Add the key and run the request again.</td></tr></tbody></table>

## Result Codes and Result Texts

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://legacy-docs.usesmileid.com/products/for-individuals-kyc/aml-check/aml-news.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.