API Explorer

Corporate Procurement Contract Awards

Data as of Jun 30, 2024

This set of data includes listings of large value contracts awards that were executed by the World Bank Group, pursuant to its Corporate Procurement Policies and Procedures. The listing includes both fixed price and indefinite delivery / indefinite quantity (IDIQ) contracts with an estimated value above US$250,000. The value for Fixed Price contracts is disclosed at the award value. The value for IDIQ contracts is not disclosed and is based on an estimate of possible value which is $250,000 or greater. This data set does not list all contracts awarded by the World Bank Group, and should be viewed only as a guide to determine the distribution of major contract commitments made by the World Bank Group. "Supplier Country / Economy" represents place of supplier registration in the World Bank's Vendor Database, which may or not be the supplier's actual country / economy of origin. Please note that the Corporate Procurement Unit is responsible for ensuring that procurement awards are consistent with procurement policies and procedures, while business units are accountable for the business need, expenditure policy, procurement specification and supplier selection. The information provided is believed to be accurate; however the World Bank Group is not responsible should the data be incorrect, incomplete or if data is omitted. Learn more about Corporate Procurement at https://www.worldbank.org/en/about/corporate-procurement

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
Award Date	Date when the contract was issued.	award_date	DATE
Quarter and Fiscal Year	Fiscal Year when the award was made. The World Bank Group's fiscal year starts on July 1st and ends on June 30th of the following year.	quarter_and_fiscal_year	STRING
Commodity Category	Internal material group name applicable to all good and service procured.	commodity_category	STRING
Contract Description	Description of the goods and/or services being procured.	contract_description	STRING
WBG Organization	World Bank Group institution that procured the goods and / or services.	wbg_organization	STRING
Selection Number	Unique identifier used by the World Bank Group.	selection_number	STRING
Supplier	Name of the supplier receiving the contract award.	supplier	STRING
Supplier Country	Country / Economy that the supplier listed in the WBG vendor registration.	supplier_country	STRING
Supplier Country Code	Two digits country / economy code for the supplier.	supplier_country_code	STRING
Contract Award Amount	Estimated value of the initial contract award.	contract_award_amount	NUMBER
Fund Source	Indicates source of funds.	fund_source	STRING
VPU description	WBG’s Vice Presidential Unit that procured the goods and / or services.	vpu_description	STRING
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

DS00028

Data Provided By

World Bank Group

Owner

Finances One

Date Created

Feb 1, 2013

Last Updated

Sep 30, 2024

Licensing and Attribution

License

Creative Commons Attribution 4.0 International

Additional Information

Type

Time Series

Row Label

Selection Number

Source

World Bank Group

Periodicity

Quarter

Granularity

Other

Provenance

official

Update Frequency

Quarterly

Economy Coverage

World

Range Column

award_date

General Access Options

Query tool,API,Bulk download

Language

English

Update Schedule

Within 90 days after end of the quarter

Data As Of

Jun 30, 2024

Data Last Updated

Sep 30, 2024

Metadata Last Updated

Sep 27, 2024

Scope

Institution

IBRD, IDA, IFC, MIGA

Topics

CategoryProcurement

Tags

country level

What's in this Dataset?

Rows

3,568

Columns

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

fetch('https://datacatalogapi.worldbank.org/dexapps/fone/api/apiservice?datasetId=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&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=DS00028&resourceId=RS00025&top=100&type=json"

API Explorer

Corporate Procurement Contract Awards

Please Note:

Request URL

Response Body

Response Code