API Explorer

Contract Awards in Investment Project Financing - Vietnam Projects

Data as of Dec 21, 2024

The data available here now includes all contract awards financed by The World Bank under Investment Project Financing (IPF) operations. The data source is STEP (Systematic Tracking of Exchanges in Procurement), which is required to be used by Borrowers in all IPF operations subject to the World Bank’s Procurement Regulations. Data is entered by Borrowers. "Supplier Country / Economy" represents the place of supplier registration, which may or may not be the supplier's actual country of origin. Information does not include awards to subcontractors, nor does it account for cofinancing. The World Bank’s Procurement Group does not guarantee the data included on this site and accepts no responsibility whatsoever for any consequences of its use. The World Bank complies with all sanctions applicable to World Bank transactions.

Visit the World Bank Procurement website for more information: https://www.worldbank.org/en/projects-operations/products-and-services/procurement-projects-programs

If you would like to review the Prior reviewed project procurement contracts since FY2001, please refer to https://financesone.worldbank.org/contract-awards-in-investment-project-financing-(since-fy-2001-fy-2016)/DS01004

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 lending is grouped into regions based on the current World Bank administrative (rather than geographic) region where project implementation takes place. The Other Region is used for loans to the IFC.	region	STRING
Borrower Country / Economy	Country / Economy to which loan or credit has been issued. Loans to the IFC are included under the country / economy “World”.	borrower_country	STRING
Borrower Country / Economy Code	Country / Economy Code according to the World Bank country / economy list. Might be different from the ISO country / economy code.	borrower_country_code	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
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
Project Global Practice	Indicates major sector for specific contract.	project_global_practice	STRING
WB Contract Number	Internal World Bank Contract number.	wb_contract_number	STRING
Contract Description	Contract description as it appears in the signed agreement.	contract_description	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 Country / Economy Code	Supplier Country / Economy Code according to the World Bank country / economy list. Might be different from the ISO country / economy code.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.	supplier_country_code	STRING
Supplier Contract Amount (USD)	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_usd	NUMBER
Borrower Contract Reference Number	Contract reference number used by Borrower.	borrower_contract_reference_number	STRING
Review type	The Bank reviews whether the Borrower’s procurement process complies with the legal agreement and the Procurement Regulations for Borrowers either prior to or post procurement.	review_type	STRING
Dataset ID	ID of the associated Dataset		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

DS01588

Data Provided By

World Bank Group

Owner

Finances One

Date Created

Nov 1, 2022

Last Updated

Dec 21, 2024

Licensing and Attribution

License

Creative Commons Attribution 4.0 International

Additional Information

Type

Time Series

Row Label

WB Contract Number

Source

World Bank Group

Periodicity

Day

Granularity

Other

Provenance

official

Update Frequency

Daily

Economy Coverage

World

Range Column

as_of_date, contract_signing_date

General Access Options

Query tool,API,Mobile App,Bulk download

Language

English

Update Schedule

Daily updates when new records are available

Data As Of

Dec 21, 2024

Data Last Updated

Dec 21, 2024

Metadata Last Updated

Nov 04, 2024

Scope

Institution

IBRD, IDA

Topics

CategoryProcurement

Tags

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

fetch('https://datacatalogapi.worldbank.org/dexapps/fone/api/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&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/view?viewId=DS01588&top=100&type=json"

API Explorer

Contract Awards in Investment Project Financing - Vietnam Projects

Please Note:

Request URL

Response Body

Response Code