---
title: World Bank Restricted Firms Screening API
slug: world-bank-debarred-firms-screening-api
url: https://apyhub.com/193market/service/world-bank-debarred-firms-screening-api
provider: 193market
tags: [compliance]
auth: api_key
version: 0.2.0
service_type: sync
endpoints: 6
atoms: 10
mcp: true
---

# World Bank Restricted Firms Screening API

Screen company names against the World Bank Group debarment list with fuzzy matching, aliases and a change feed.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/screen` | What it does Checks one firm name against the debarred and cross-debarred firms list. Matching hand… | 10 |
| POST | `https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/screen/batch` | What it does Screens multiple firm names in one request. Submit 1–50 names and optionally apply one… | 10 |
| GET | `https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/firms` | What it does Browses the debarment list with pagination and optional filters for country, status, c… | 10 |
| GET | `https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/changes` | What it does Returns incremental list changes from a specified date. Each event identifies when the… | 10 |
| GET | `https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/firms/:firm_id` | What it does Looks up one firm by its numeric ID and returns the firm's current details together wi… | 10 |
| GET | `https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/codes` | What it does Returns reference definitions used by the other endpoints, including debarment statuse… | 10 |

## Endpoint reference

### Screen a Company Against the Debarment List

`GET https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/screen` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | query | string | yes | Company name in Latin letters, any legal suffix, e.g. Roprucsa |
| `limit` | query | integer | no | Maximum matches, 1–20 Default: `5`. |
| `country` | query | string | no |  |
| `threshold` | query | number | no | Minimum match score 0.5–1.0 (default 0.8) Default: `0.8`. |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/screen?name=APPLUS%20SERVICIOS%20INTEGRALES%2C%20SAS&threshold=0.5" \
  -H 'apy-token: $APY_TOKEN'
```
##### What you will get 
```json
{
  "query": {
    "name": "APPLUS SERVICIOS INTEGRALES, SAS",
    "normalised": "APPLUS SERVICIOS INTEGRALES",
    "country": null,
    "threshold": 0.5
  },
  "matched": true,
  "best_score": 1,
  "matches": [
    {
      "match_score": 1,
      "matched_name": "APPLUS SERVICIOS INTEGRALES, SAS",
      "matched_on": "name",
      "shared_distinctive_words": [
        "APPLUS",
        "SERVICIOS",
        "INTEGRALES"
      ],
      "id": 1102469,
      "name": "APPLUS SERVICIOS INTEGRALES, SAS",
      "entity_type": "firm",
      "other_names": [],
      "native_script_names": [],
      "registration_numbers": [],
      "country": {
        "code": "CO",
        "name": "Colombia"
      },
      "city": "BOGOTÁ",
      "status": "cross_debarred",
      "currently_ineligible": true,
      "ineligible_from": "2026-06-26",
      "ineligible_to": "2027-07-10",
      "permanent": false,
      "basis": "Cross Debarment: EBRD",
      "cross_debarment_by": "EBRD",
      "controlled_affiliate_of_sanctioned_entity": false,
      "sanction_scope_note": null,
      "listed_since": "2026-06-26",
      "on_current_list": true
    }
  ],
  "data_freshness": {
    "list_checked_at": "2026-09-25T10:33:14+00:00",
    "list_changed_at": "2026-09-25T10:33:14+00:00",
    "firms_on_list": 1249
  }
}
```

### Screen Multiple Companies Against the Debarment List

`POST https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/screen/batch` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `names` | body | array of string | yes | Up to 50 company names |
| `country` | body | any | no | Optional ISO country code applied to every name |
| `threshold` | body | number | no | Threshold Default: `0.8`. |

#### Quickstart

```bash
curl -X POST "https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/screen/batch" \
  -H 'apy-token: $APY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"names":["INSHA TRADE CORPORATION","Medical Items","Enterprise Babati"],"threshold":0.8}'
```
##### What you will get 

```json
{
  "count": 3,
  "screened": 3,
  "results": [
    {
      "query": {
        "name": "INSHA TRADE CORPORATION",
        "normalised": "INSHA TRADE",
        "country": null,
        "threshold": 0.8
      },
      "matched": true,
      "best_score": 1,
      "matches": [
        {
          "match_score": 1,
          "matched_name": "INSHA TRADE CORPORATION",
          "matched_on": "name",
          "shared_distinctive_words": [
            "INSHA",
            "TRADE"
          ],
          "id": 1017035,
          "name": "INSHA TRADE CORPORATION",
          "entity_type": "firm",
          "other_names": [],
          "native_script_names": [],
          "registration_numbers": [],
          "country": {
            "code": "BD",
            "name": "Bangladesh"
          },
          "city": "DHAKA-1000",
          "status": "debarred",
          "currently_ineligible": true,
          "ineligible_from": "2026-09-10",
          "ineligible_to": "2029-09-09",
          "permanent": false,
          "basis": "Fraudulent Practice",
          "cross_debarment_by": null,
          "controlled_affiliate_of_sanctioned_entity": false,
          "sanction_scope_note": null,
          "listed_since": "2020-07-13",
          "on_current_list": true
        }
      ]
    },
    {
      "query": {
        "name": "Medical Items",
        "normalised": "MEDICAL ITEMS",
        "country": null,
        "threshold": 0.8
      },
      "matched": true,
      "best_score": 1,
      "matches": [
        {
          "match_score": 1,
          "matched_name": "MEDICAL ITEMS",
          "matched_on": "name",
          "shared_distinctive_words": [
            "MEDICAL",
            "ITEMS"
          ],
          "id": 1112457,
          "name": "MEDICAL ITEMS",
          "entity_type": "firm",
          "other_names": [],
          "native_script_names": [],
          "registration_numbers": [
            "RCCM-NI-NIA-2011-B-1536"
          ],
          "country": {
            "code": "NE",
            "name": "Niger"
          },
          "city": "NIAMEY",
          "status": "debarred",
          "currently_ineligible": true,
          "ineligible_from": "2026-08-04",
          "ineligible_to": "2029-07-03",
          "permanent": false,
          "basis": "Controlled Affiliate of a Sanctioned Entity.",
          "cross_debarment_by": null,
          "controlled_affiliate_of_sanctioned_entity": true,
          "sanction_scope_note": null,
          "listed_since": "2026-08-04",
          "on_current_list": true
        }
      ]
    },
    {
      "query": {
        "name": "Enterprise Babati",
        "normalised": "ENTERPRISE BABATI",
        "country": null,
        "threshold": 0.8
      },
      "matched": true,
      "best_score": 0.957,
      "matches": [
        {
          "match_score": 0.957,
          "matched_name": "ENTREPRISE BABATI",
          "matched_on": "name",
          "shared_distinctive_words": [
            "ENTREPRISE",
            "BABATI"
          ],
          "id": 1112455,
          "name": "ENTREPRISE BABATI",
          "entity_type": "firm",
          "other_names": [],
          "native_script_names": [],
          "registration_numbers": [
            "RCCM/NIG/TAH/2011/B/109"
          ],
          "country": {
            "code": "NE",
            "name": "Niger"
          },
          "city": "NIAMEY",
          "status": "debarred",
          "currently_ineligible": true,
          "ineligible_from": "2026-08-04",
          "ineligible_to": "2029-07-03",
          "permanent": false,
          "basis": "Fraudulent Practice",
          "cross_debarment_by": null,
          "controlled_affiliate_of_sanctioned_entity": false,
          "sanction_scope_note": null,
          "listed_since": "2026-08-04",
          "on_current_list": true
        }
      ]
    }
  ],
  "data_freshness": {
    "list_checked_at": "2026-09-25T10:33:14+00:00",
    "list_changed_at": "2026-09-25T10:33:14+00:00",
    "firms_on_list": 1249
  }
}
```

### Firms on the list, filtered by country, basis or dates

`GET https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/firms` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | Page Default: `1`. |
| `status` | query | string | no |  |
| `country` | query | string | no |  |
| `per_page` | query | integer | no | 1–100 Default: `50`. |
| `listed_since` | query | string | no |  |
| `cross_debarment_by` | query | string | no |  |
| `ineligible_from_since` | query | string | no |  |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/firms?page=10&per_page=50" \
  -H 'apy-token: $APY_TOKEN'
```

##### What you will get 

```json
{
  "total": 1249,
  "page": 10,
  "per_page": 50,
  "results": [
    {
      "id": 888258,
      "name": "HEBEI CONSTRUCTION GROUP CORPORATION LIMITED CHENGDE CONCRETE BRANCH",
      "entity_type": "firm",
      "other_names": [],
      "native_script_names": [
        "河北天睿项目管理有限公司"
      ],
      "registration_numbers": [],
      "country": {
        "code": "CN",
        "name": "China"
      },
      "city": "CHENGDE CITY, HEBEI PROVINCE",
      "status": "cross_debarred",
      "currently_ineligible": true,
      "ineligible_from": "2024-08-22",
      "ineligible_to": "2027-07-22",
      "permanent": false,
      "basis": "Cross Debarment: ADB",
      "cross_debarment_by": "ADB",
      "controlled_affiliate_of_sanctioned_entity": false,
      "sanction_scope_note": null,
      "listed_since": "2024-08-22",
      "on_current_list": true
    },
    {
      "id": 888259,
      "name": "HEBEI CONSTRUCTION GROUP CORPORATION LIMITED CHENGDE SHAUNGLUAN CONCRETE BRANCH",
      "entity_type": "firm",
      "other_names": [],
      "native_script_names": [
        "河北建设集团股份有限公司混凝土分公司"
      ],
      "registration_numbers": [],
      "country": {
        "code": "CN",
        "name": "China"
      },
      "city": "CHENGDE CITY, HEBEI PROVINCE",
      "status": "cross_debarred",
      "currently_ineligible": true,
      "ineligible_from": "2024-08-22",
      "ineligible_to": "2027-07-22",
      "permanent": false,
      "basis": "Cross Debarment: ADB",
      "cross_debarment_by": "ADB",
      "controlled_affiliate_of_sanctioned_entity": false,
      "sanction_scope_note": null,
      "listed_since": "2024-08-22",
      "on_current_list": true
    }
  ]
}
```

### Firms added to, removed from or changed on the list

`GET https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/changes` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | Page Default: `1`. |
| `since` | query | string | yes | ISO date or datetime (UTC), e.g. 2026-09-01 |
| `per_page` | query | integer | no | 1–200 Default: `100`. |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/changes?since=2024-08-22" \
  -H 'apy-token: $APY_TOKEN'
```

##### What you will get 

```json
{
  "since": "2024-08-22",
  "tracking_since": "2026-09-21T23:18:51+00:00",
  "note": "the first snapshot records every firm as added; changes after that are real list changes",
  "results": [
    {
      "at": "2026-09-21T23:18:51+00:00",
      "kind": "added",
      "detail": null,
      "firm": {
        "id": 118351,
        "name": "ZHONGKE LIFE SCIENCE & TECHNOLOGY CO., LTD.",
        "entity_type": "firm",
        "other_names": [],
        "native_script_names": [],
        "registration_numbers": [],
        "country": {
          "code": "CN",
          "name": "China"
        },
        "city": "ZHEJIANG 313200",
        "status": "debarred",
        "currently_ineligible": true,
        "ineligible_from": "2011-07-26",
        "ineligible_to": null,
        "permanent": true,
        "basis": "Procurement Guidelines 1.14(a)(ii)",
        "cross_debarment_by": null,
        "controlled_affiliate_of_sanctioned_entity": false,
        "sanction_scope_note": null,
        "listed_since": null,
        "on_current_list": true
      }
    },
    {
      "at": "2026-09-21T23:18:51+00:00",
      "kind": "added",
      "detail": null,
      "firm": {
        "id": 322505,
        "name": "OLIVE HEALTH CARE",
        "entity_type": "firm",
        "other_names": [],
        "native_script_names": [],
        "registration_numbers": [],
        "country": {
          "code": "IN",
          "name": "India"
        },
        "city": "MUMBAI 400 022",
        "status": "debarred",
        "currently_ineligible": true,
        "ineligible_from": "2017-07-21",
        "ineligible_to": "2028-01-20",
        "permanent": false,
        "basis": "May 2010 Procurement Guidelines, Para. 1.14(a)(i) & (ii)",
        "cross_debarment_by": null,
        "controlled_affiliate_of_sanctioned_entity": false,
        "sanction_scope_note": null,
        "listed_since": "2015-09-02",
        "on_current_list": true
      }
    }
  ]
}
```

### One firm, with its change history

`GET https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/firms/:firm_id` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `firm_id` | path | string | yes | Firm Id |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/firms/:firm_id/1102470" \
  -H 'apy-token: $APY_TOKEN'
```
##### What you will get 

```json
{
  "firm": {
    "id": 1102470,
    "name": "INGELOG COSTA RICA, S.A.",
    "entity_type": "firm",
    "other_names": [],
    "native_script_names": [],
    "registration_numbers": [],
    "country": {
      "code": "CR",
      "name": "Costa Rica"
    },
    "city": "OFICINA T&L CONSULTORES",
    "status": "cross_debarred",
    "currently_ineligible": true,
    "ineligible_from": "2026-06-26",
    "ineligible_to": "2027-07-10",
    "permanent": false,
    "basis": "Cross Debarment: EBRD",
    "cross_debarment_by": "EBRD",
    "controlled_affiliate_of_sanctioned_entity": false,
    "sanction_scope_note": null,
    "listed_since": "2026-06-26",
    "on_current_list": true
  },
  "history": [
    {
      "at": "2026-09-21T23:18:51+00:00",
      "kind": "added",
      "detail": null
    }
  ],
  "data_freshness": {
    "list_checked_at": "2026-09-25T10:33:14+00:00",
    "list_changed_at": "2026-09-25T10:33:14+00:00",
    "firms_on_list": 1249
  }
}
```

### What the fields mean

`GET https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/codes` · 10 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/world-bank-debarred-firms-screening-api/codes" \
  -H 'apy-token: $APY_TOKEN'
```

##### What you will get 

```json
{
  "status": {
    "debarred": "debarred by the World Bank itself",
    "cross_debarred": "debarred by another multilateral development bank and enforced by the World Bank under the 2010 Agreement for Mutual Enforcement of Debarment Decisions"
  },
  "match_score": "0–1. Accents, punctuation, word order and legal suffixes such as LTD, S.A. or GmbH are ignored. Each word is weighted by how rare it is on the list, so a shared common word such as CONSTRUCTION or CHINA counts little, and a match needs at least one rare word in common (small spelling differences allowed). Former names and trading names are checked too.",
  "matched_on": {
    "name": "the listed name",
    "other_name": "a former, trading or 'also known as' name recorded in the list's notes"
  },
  "currently_ineligible": "on the current list and the ineligibility end date has not passed (or is permanent)",
  "listed_since": "the date the World Bank added the entry to its list",
  "sanction_scope_note": "limits written in the list, e.g. 'only for its business operations in the water sector'",
  "data_freshness": {
    "list_checked_at": "2026-09-25T10:33:14+00:00",
    "list_changed_at": "2026-09-25T10:33:14+00:00",
    "firms_on_list": 1249
  }
}
```

## About

World Bank Restricted Firms Screening API checks whether firms appear on the World Bank Group’s debarred or cross-debarred firms list. Send firm names for screening, and it returns whether a match was found along with the matched firm’s name, country, aliases, registration details, sanction status, sanction basis, and ineligibility dates. Use it for supplier screening, procurement workflows, partner due diligence, onboarding, and compliance checks.

The API supports batch screening, allowing multiple firm names to be checked in a single request. Its fuzzy matching handles common differences such as spelling variations, accents, punctuation, word order, legal-form suffixes, and alternative firm names, making it useful when submitted firm names do not exactly match the listed records.

You can also browse and filter debarred firms, retrieve detailed firm information and change history, access reference codes, and track firms that have been added, removed, or changed over time. This makes the API suitable for automated compliance workflows that need to screen firms and stay updated with changes to the World Bank debarment list

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/193market/service/world-bank-debarred-firms-screening-api