Get Region Project Counts

This operation retrieves all regions and countries with their associated project counts. This is a non-secure request as indicated by the '/public/' element in the URL path, therefore, an access token (authentication) is not required.

HTTP Method:

GET

Content Type:

xml, json

Accept Type:

xml, json

Path:

https://api.globalgiving.org/api/public/projectservice/regions/countries/projects/count

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/api/public/projectservice/regions/countries/projects/count?api_key=YOUR_API_KEY

tip

TIP: Adding '/active' to the path returns only active projects able to accept donations. Funded and retired projects are excluded.

Example:

/api/public/projectservice/regions/countries/projects/active/count?api_key=YOUR_API_KEY

HTTP GET Request using cURL:

                  curl -H "Accept: application/xml" -H "Content-Type: application/xml" -X GET "https://api.globalgiving.org/api/public/projectservice/regions/countries/projects/count?api_key=YOUR_API_KEY"
               

XML Response:

            
                  <?xml version="1.0" encoding="utf-8" standalone="yes"?>
                  <regions>
                     <region>
                        <countries>
                           <country>
                              <iso3166CountryCode>BF</iso3166CountryCode>
                              <name>Burkina Faso</name>
                              <projectCount>3</projectCount>
                           </country>
                           <country>
                              <iso3166CountryCode>BI</iso3166CountryCode>
                              <name>Burundi</name>
                              <projectCount>2</projectCount>
                           </country>
                              . 
                              .
                        </countries>
                        <name>Africa</name>
                     </region>
                     . 
                     . 
                  </regions>
               

NOTE: The <region> and <country> elements are repeating.

Get Region Project Counts Response Structure

regions

region [one or more]

countries

country [one or more]

name string
iso3166CountryCode string
projectCount int
name string

Element Definitions For Get Region Project Counts Response

Element Mandatory Description
regions -> region -> countries -> country -> name required Name of country.
iso3166CountryCode required ISO 3166 Country codeexternal link.
projectCount required Count of projects in that country.
regions -> region -> name required Name of region.