# Counterparty Check: Sanctions, LEI, US Contracts (`dataforge_api/counterparty-risk-check-ppe`) Actor

Check company names against OFAC, UN and UK sanctions lists, then add LEI status, ultimate parent and US federal contract totals. Returns a risk score, evidence links and a clear potential-match disclaimer. Legal entities only.

- **URL**: https://apify.com/dataforge_api/counterparty-risk-check-ppe.md
- **Developed by:** [DataForge Lab](https://apify.com/dataforge_api) (community)
- **Categories:** Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Counterparty Check: Sanctions, LEI, US Contracts

A screening helper, not a compliance or KYC service.

Screen the companies you do business with in one run. Give company names, get a risk score with the evidence behind it: sanctions-list hits, LEI status and ultimate parent, and federal contract totals from the US.

### Sources (all official and open)

- **Sanctions:** OFAC SDN and Consolidated lists (US Treasury), UN Security Council Consolidated List, UK Sanctions List (FCDO). The lists are downloaded fresh on every run.
- **GLEIF** Legal Entity Identifier register: LEI, registration status, ultimate parent.
- **USAspending.gov:** federal award total for the recipient.

### Output per company

`risk_level` (high, review, low_or_unknown), `recommended_action` (escalate, review, retry, no_action_from_this_check) with `action_reason`, `risk_score`, `risk_flags` (`sanctions_exact_match`, `sanctions_possible_match`, `lei_not_active`, `entity_not_active`), `sanctions_hits` with list, listed name, matched alias, program, list reference, match method and confidence, source link, plus LEI and USAspending fields in the deep report. Every record carries a disclaimer.

### How matching works

Names are normalised (case, accents, punctuation, legal suffixes such as Ltd, LLC, GmbH, JSC). Exact and word-order-insensitive matches are reported as exact. Close variants are reported as `fuzzy` with a confidence and only as a possible match.

### Read this before relying on it

- **A hit is a potential match, not a legal finding.** Always verify at the official source linked in the record. `no_match_in_checked_lists` does not mean the company is clean; every record also lists what was not covered (`not_covered`). A missing hit does not prove a company is clean: names can be spelled differently, and sanctioned owners of a company are not detected.
- Only **legal entities** are screened. People are deliberately excluded.
- The EU consolidated list is not included.
- The USAspending figure is the total reported for the recipient profile over the years it covers, not a 12-month figure. LEI and USAspending lookups need an exact name match; a company without an LEI simply returns no LEI fields.
- This tool supports compliance workflows. It is not legal advice.

### Pricing

Pay per event: `counterparty-risk-check-check` $0.04 per company and `counterparty-risk-check-deep-report` $0.08 extra per company when an LEI record or USAspending profile is found. If no sanctions list can be loaded, the run stops and nothing is charged.

### Use cases

- **Supplier onboarding:** screen every new vendor name against OFAC, UN and UK lists before the first payment.
- **Periodic re-check:** run your vendor list on a schedule and review only the rows with a potential match.
- **Due diligence:** add the GLEIF LEI status, ultimate parent and US federal contract totals to a company profile.

Published task examples on this Actor's page show ready-made inputs for each case.

### Related Actors

- [Company Contact Finder](https://apify.com/dataforge_api/company-contact-finder-ppe): public emails and phones from a company website
- [New Company Registrations Feed](https://apify.com/dataforge_api/new-business-registrations-ppe): newly registered companies in Norway and Finland
- [US Federal Contract Awards](https://apify.com/dataforge_api/us-sam-gov-active-awards-ppe): who wins US federal contracts

# Actor input Schema

## `counterparties` (type: `array`):

Company names to check, one per line. Add a two-letter country code after a vertical bar to improve the LEI lookup, for example Siemens AG|DE. Only legal entities are screened; do not enter people's names.

## `sanctionsLists` (type: `array`):

Which lists to screen against: OFAC (SDN and consolidated), UN, UK. The EU list is not included.

## `deepReport` (type: `boolean`):

Also look up the company in the GLEIF LEI register (status, ultimate parent) and in USAspending (federal award total). Charged as an extra event only when something is found.

## Actor input object example

```json
{
  "counterparties": [
    "Rosneft Oil Company",
    "Apple Inc.|US",
    "Bank Melli Iran"
  ],
  "sanctionsLists": [
    "OFAC",
    "UN",
    "UK"
  ],
  "deepReport": true
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("dataforge_api/counterparty-risk-check-ppe").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("dataforge_api/counterparty-risk-check-ppe").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call dataforge_api/counterparty-risk-check-ppe --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataforge_api/counterparty-risk-check-ppe"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/snRF3tEBX3gHIw6X2/builds/f72aMnfq8U8aYhAYh/openapi.json
