API Explorer

Contract Awards in Investment Project Financing (since FY 2001 - FY 2016)

Data as of Mar 11, 2022

This set of contract awards includes data on commitments against contracts that were reviewed by the Bank before they were awarded (prior-reviewed Bank-funded contracts) under IDA/IBRD investment projects and related Trust Funds. This dataset does not list all contracts awarded by the Bank, and should be viewed only as a guide to determine the distribution of major contract commitments among the Bank's member countries. "Supplier Country / Economy" represents place of supplier registration, which may or not be the supplier's actual country of origin. Information does not include awards to subcontractors nor account for cofinancing. The Procurement Policy and Services Group does not guarantee the data included in this publication and accepts no responsibility whatsoever for any consequences of its use. The World Bank complies with all sanctions applicable to World Bank transactions.

Visit Bank’s Procurement page for more information: https://www.worldbank.org/en/projects-operations/products-and-services/procurement-projects-programs

If you would like to view the most recent information on Project procurement contracts including the contracts that underwent post review, please refer to,

https://finances.worldbank.org/Procurement/Major-Contract-Awards/kdui-wcs3

Information presented on this retired dataset is as of 11-Mar-2022, any modifications after that may not be reflected. Note that contracts may be modified after signature.

Important Note

We recommend users to adopt API service option only for datasets exceeding a million records. For other datasets, kindly use the JSON link available on the "Actions and Tools" section which enables extraction of all the records at once.

Parameters

Parameter	Description	API FIELD NAME	Data Type
As of Date	Represents the date when this snapshot was taken.	as_of_date	DATE
Fiscal Year	The fiscal year begins on July 1st of the previous year and runs through June 30th of the designated year.	fiscal_year	NUMBER
Region	Country / Economy lending is grouped into regions based on the current World Bank administrative (rather than geographic) region where project implementation takes place.	region	STRING
Borrower Country / Economy	Country / Economy to which loan or credit has been issued.	borrower_country	STRING
Project ID	A Bank project is referenced by a project ID (Pxxxxxxx). More than one loan, credit, or grant may be associated with one Project ID.	project_id	STRING
Project Name	Short descriptive project name.	project_name	STRING
Project Global Practice	Indicates major sector for specific contract.	project_global_practice	STRING
Procurement Category	Describes procurement category.	procurement_category	STRING
Procurement Method	The method used for selecting a contractor, supplier or consultant. The method used depends upon the Procurement Category.	procurement_method	STRING
Contract Number	Internal World Bank Contract number.	contract_number	NUMBER
Contract Description	Contract description as it appears in the signed agreement.	contract_description	STRING
Borrower Contract Reference Number	Contract reference number used by Borrower.	borrower_contract_reference_number	STRING
Contract Signing Date	Date when the contract was signed.	contract_signing_date	DATE
Supplier	The name of the contractor, supplier or consultant who submitted the winning bid or proposal. The name of the manufacturer, Joint Venture partners, sub-contractor, and/or sub-consultants may not appear.	supplier	STRING
Supplier Country / Economy	The nationality of awarded firms is based on place of registration, which may or may not be the same as the country / economy of origin. For the country / economy where the work is being performed, or the goods are being delivered, use Borrower Country / Economy.	supplier_country	STRING
Supplier Contract Amount (US$)	All contract values reflect committed (not disbursed) amounts, and are in US dollars, based on the US Treasury's rate of exchange at the time of the Bank's no objection to the contract award.	supplier_contract_amount	NUMBER
Resource ID	ID of the associated Resource		STRING
Select	Fields that required E.g (fiscal_year\|supplier_country\|total_amount)		STRING
Top	Number of records to fetch		NUMBER
Skip	Skip the records from the ascending order		NUMBER

Please Note:

This API will support up to a maximum of 1000 records per request / page.
The date format for all date fields should be DD-MMM-YYYY.
Selection will allow for multiple parameters E.g (Country = India|Afghanistan).
The filters for blank and non-blank should be IS NULL and IS NOT NULL E.g (Country = IS NULL, Country = IS NOT NULL)

Dataset Identifier

DS01004

Data Provided By

World Bank Group

Owner

Finances One

Date Created

Mar 18, 2022

Last Updated

Nov 13, 2024

Licensing and Attribution

License

Creative Commons Attribution 4.0 International

Additional Information

Type

Time Series

Row Label

Contract Number

Source

World Bank Group

Periodicity

Day

Granularity

Other

Provenance

official

Update Frequency

No further updates planned

Economy Coverage

World

Range Column

fiscal_year, contract_signing_date

General Access Options

Query tool,API,Mobile App,Bulk download

Language

English

Update Schedule

No further updates planned

Data As Of

Mar 11, 2022

Data Last Updated

Nov 13, 2024

Metadata Last Updated

Nov 13, 2024

Scope

Institution

IBRD, IDA

Topics

CategoryProcurement

Tags

What's in this Dataset?

Rows

146,802

Columns

JavaScript makes it super simple to fetch from an API endpoint.

fetch('https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json')
    .then(response => {
        if (!response.ok) {
            throw new Error('');
        }
        return response.json();
    })
    .then(data => {
        // Do something with the response data
        // console.log(data);
    })
    .catch(error => {
        console.error('Error:', error);
    });

Python for easily work with data.

import requests
url = 'https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json'
try:
    response = requests.get(url)
    response.raise_for_status()  # Raise an exception for 4XX and 5XX status codes
    data = response.json()  # Parse the JSON response
    print(data)  # Print the response data
except requests.RequestException as e:
    print(f'Error: {e}')

PowerShell code to extract data.

$url = 'https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json'
try {
    $response = Invoke-RestMethod -Uri $url -Method Get
    # Print the response
    Write-Output $response
} catch {
    # Print error message if request fails
    Write-Error "Error: $_"
}

The following snippet brings data into your application.

require 'net/http'
url = URI('https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json')
begin
response = Net::HTTP.get_response(url)
if response.is_a?(Net::HTTPSuccess)
    puts response.body
else
    puts "Error: #{response.code} - #{response.message}"
end
rescue StandardError => e
puts "Error: #{e.message}"
end

Below code that makes usage with .NET more natural.

using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
    static async Task Main(string[] args)
    {
        var response = await new HttpClient().GetStringAsync("https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json");
        Console.WriteLine(response);
    }
}

JAVA for easily work with data.

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("GET");
        BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
        String line;
        StringBuffer response = new StringBuffer();
        while ((line = reader.readLine()) != null) {
            response.append(line);
        }
        reader.close();
        System.out.println(response.toString());
    }
}

The following snippet brings data into your application.

shell "curl -X GET https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json"

PHP code to brings the data.

<?php
// Specify the URL you want to send the GET request to
$url = "https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json";
// Initialize cURL session
$curl = curl_init();
// Set the cURL options
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
// Execute cURL session
$response = curl_exec($curl);
// Close cURL session
curl_close($curl);
// Print the response
echo $response;
?>

Copy and paste the following to import this dataset into Stata.

clear
. import delimited "https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS01004&resourceId=RS00934&top=100&type=json"

API Explorer

Contract Awards in Investment Project Financing (since FY 2001 - FY 2016)

Please Note:

Request URL

Response Body

Response Code