Get Regions

This operation retrieves all regions. 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

Query String Parameters:

&api_key described in the API Key section, required

Query String Example:

/api/public/projectservice/regions?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?api_key=YOUR_API_KEY"

XML Response:

            
                  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
                  <regions>
                     <region>        
                        <name>Africa</name>
                     </region>
                     <region>
                     .
                     .
                     <region>
                        <name>South/Central America and the Caribbean</name>
                     </region>
                  </regions>

NOTE: The <region> elements are repeating.

Get Regions Response Structure

regions

region [one or more]

name string

Element Definitions For Get Regions Response

Element Mandatory Description
name required Name of region.