> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getclean.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> getclean's own MCP server is at https://mcp.getclean.ai/mcp. The /mcp path of this docs site is Mintlify's search over these pages, not getclean.
> Every answer of the API opens with outcome. A page that could not be read is a record whose outcome says why, never an HTTP error; read outcome before anything else.
> The API's contract is the OpenAPI 3.1 file at https://docs.getclean.ai/openapi.yaml; the SDKs are generated from it.
> The product's name is written getclean, in lower case.

# Counterparty screening: what the company says, and what others say

> Screen a company by its registry codes, in the languages of its country. Each result says whether its source is the company or is independent of it, and a story printed on 30 sites counts once.

An analyst screens a new distributor in Turkey before a contract is signed. A search in English finds the company's own site and 30 favorable articles, and the file is closed as clean. The court notice was in Turkish, and the 30 articles were one press release, printed 30 times. This page builds a screening that searches in the languages of the company's country, counts a copied text once, and separates what the company says about itself from what others say.

## The run in 5 steps

### Name the company by its codes

A name can belong to 2 companies. A registry number, a tax number, and a LEI each name one. The catalog of datasources lists, for each register, the code of the body that issues its numbers. Your agent reads the issuer codes from there and does not guess one.

### Search in the company's languages

Nothing is translated: a wording in Turkish finds pages in Turkish. So your agent writes the question in each language that the sources are written in. This search asks in English and in Turkish, in 5 wordings.

```json Request body of search theme={"theme":"css-variables"}
{
  "query": "COMPANY_NAME (fraud OR sanctions OR insolvency OR investigation)",
  "alternate_queries": [
    "COMPANY_NAME (dolandırıcılık OR yaptırım OR iflas OR soruşturma)",
    "COMPANY_NAME (konkordato OR icra takibi)",
    "COMPANY_NAME (court ruling OR penalty)",
    "COMPANY_NAME (mahkeme kararı OR idari para cezası)"
  ],
  "subject_identifiers": [
    { "scheme": "registry", "value": "REGISTRY_NUMBER", "issuer": "REGISTRY_ISSUER" },
    { "scheme": "tax_id", "value": "TAX_NUMBER", "issuer": "TAX_ISSUER" },
    { "scheme": "lei", "value": "LEI_CODE" }
  ],
  "subject_country": "TR",
  "source_kinds": ["court", "regulator", "state", "press", "company"],
  "ranking_priorities": ["independent", "official"],
  "purpose": "Screening of a new distributor before a contract is signed. Find court cases, sanctions, insolvency filings, and penalties against the company or its owners.",
  "max_candidates": 30
}
```

Replace `COMPANY_NAME` with the company's name as it is registered. Replace the 5 placeholders in `subject_identifiers` with the company's codes and the issuer codes from the catalog.

`ranking_priorities` puts the sources that are independent of the company first, and official sources first among them. Nothing is removed: the company's own pages are still in the list, after the others.

### Split the results into 2 columns

Each result says what kind of source it is and whether that source is independent of the company. This response is cut to 3 results and to the fields that this step explains.

```json Part of the response theme={"theme":"css-variables"}
{
  "candidates": [
    {
      "language": "tr",
      "source_profile": { "kind": "court", "role": "primary", "independence": "independent" },
      "copy_count": 0,
      "identifier_matches": [{ "scheme": "tax_id", "value": "TAX_NUMBER", "issuer": "TAX_ISSUER" }]
    },
    {
      "language": "tr",
      "source_profile": { "kind": "press", "role": "secondary", "independence": "independent" },
      "copy_count": 29,
      "identifier_matches": []
    },
    {
      "language": "en",
      "source_profile": { "kind": "company", "role": "primary", "independence": "self" },
      "copy_count": 0,
      "identifier_matches": []
    }
  ]
}
```

The first result is a notice of a court, in Turkish, and it has the company's tax number, so it is about this company and not about one with a similar name. The second is a news story that 29 other sites printed too: it is one source, not 30. The third is the company's own site.

Your report then has 2 columns: what the company states, from the results with `self`, and what others state, from the results with `independent`. A reader sees at once which claims have only the company behind them.

### Confirm that a notice names this company

Fetch the court notice, and send the company's name and its tax number against it as strings to find.

```json Request body of highlight_contents theme={"theme":"css-variables"}
{
  "highlights": ["COMPANY_NAME", "TAX_NUMBER"],
  "deterministic_only": true,
  "max_characters": 0
}
```

A string that is in the notice comes back as `exact`, with its place. No model takes part, so "the notice names this tax number" is a fact that anyone can check again.

### Store the page as it was

A court notice can be taken down. Fetch it with the bytes as served and a picture of the page, and store both with their digests. For the request, see [Keep proof of what a page showed](https://docs.getclean.ai/read/proof.md).

## What the compliance officer can check

| The compliance officer asks | What the screening has |
| - | - |
| Who says this? | For each finding, the kind of its source, and whether the source is the company or is independent of it. |
| Is it the same company? | The codes that each result matches. |
| How many sources are there, really? | The number of copies behind each result. |
| What was searched? | The receipt of the search: each wording, each datasource, and what could not be searched. |

## Know the limits

A profile says what kind of source a result is. It does not say that the source is right, and it is not a score.

Independence is stated only relative to a company that the codes resolve. Where no datasource knows the codes, each result says `unknown`, and a notice says that the priority did not apply.

A search finds what its datasources have. The catalog says which registers and courts can be searched for a country, and the receipt names what was not searched. This run is a search of public sources. It is not a check against a sanctions list.

For the calls, see [Find the exact paper, case, or company by its identifier](https://docs.getclean.ai/find/identifiers.md) and [Put primary sources first](https://docs.getclean.ai/find/rank-by-source.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.