API Explorer

IFC Financial Highlights

Data as of Jun 30, 2023

Provides select metrics from IFC annual reports. You can access Annual Reports at http://www1.ifc.org/wps/wcm/connect/CORP_EXT_Content/IFC_External_Corporate_Site/Annual+Report/ .

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
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
Net income (loss) (US$ millions)	Refer to IFC Management’s Discussion and Analysis and Annual report for more details.	net_income_loss___millions	NUMBER
Overall liquidity ratio (%)	IFC’s overall liquidity as a percentage of the next three years' estimated net cash needs.	overall_liquidity_ratio	NUMBER
Debt-to-equity ratio	The ratio of outstanding borrowings plus outstanding guarantees to subscribed capital plus undesignated retained earnings at the end of the fiscal year.	debttoequity_ratio	STRING
Estimated fair value of equity investments (US$ millions)	Refer to IFC Management’s Discussion and Analysis and Annual report for more details.	estimated_fair_value_of_equity_investments___millions	NUMBER
Grants to IDA (US$ millions)	Level of Board of Governors- approved grants to IDA.	grants_to_ida___millions	NUMBER
(Loss) Income before grants to IDA (US$ millions)	Refer to IFC Management’s Discussion and Analysis and Annual report for more details.	loss_income_before_grants_to_ida__millions	NUMBER
Investments (US$ millions)	Refer to IFC Management’s Discussion and Analysis and Annual report for more details.	investments	NUMBER
Return on average assets (GAAP basis)	Net income for the fiscal year as a percentage of the average of total assets at the end of such fiscal year and the previous fiscal year.	return_on_average_assets_gaap_basis	NUMBER
Return on average capital (GAAP basis)	Net income for the fiscal year as a percentage of the average of total capital (excluding payments on account of pending subscriptions) at the end of such fiscal year and the previous fiscal year.	return_on_average_capital_gaap_basis	NUMBER
Total Assets (US$ millions)	Refer to IFC Management’s Discussion and Analysis and Annual report for more details.	total_assets___millions	NUMBER
Total reserve against losses on loans to total disbursed loan portfolio	Total reserves against losses on loans to total disbursed loan portfolio is defined as reserve against losses on loans as a percentage of the total disbursed loan portfolio at the end of the fiscal year.	total_reserve_against_losses_on_loans_to_total_disbursed_loan_portfolio	NUMBER
Capital available (US$ billions)	Paid in capital plus retained earnings net of designated retained earnings plus general and specific reserves against losses on loans. This is the level of available resources under IFC’s risk- based economic capital adequacy framework.	capital_available___billions_	NUMBER
Capital required (US$ billions)	The minimum capital required consistent with the maintenance of IFC’s AAA rating. It is computed as the aggregation of risk- based economic capital requirements for each asset class across the Corporation.	capital_required___billions_	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

DS00998

Data Provided By

World Bank Group

Owner

Finances One

Date Created

Feb 27, 2013

Last Updated

Nov 13, 2024

Licensing and Attribution

License

Creative Commons Attribution 4.0 International

Additional Information

Type

Time Series

Source

World Bank Group

Periodicity

Annual

Granularity

Other

Provenance

official

Update Frequency

Annually

Economy Coverage

World

Range Column

fiscal_year

General Access Options

Query tool,API,Bulk download

Language

English

Update Schedule

September

Data As Of

Jun 30, 2023

Data Last Updated

Nov 13, 2024

Metadata Last Updated

Nov 13, 2024

Scope

Institution

IFC

Topics

CategoryFinancial Reporting

Tags

annual report financial statements

What's in this Dataset?

Rows

Columns

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

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

API Explorer

IFC Financial Highlights

Please Note:

Request URL

Response Body

Response Code