Openaid IATI Parser and API

OIPA is an IATI data-engine providing a rich and usable API for managing IATI compliant data.

OIPA on Github

Country List

Returns a list of IATI Countries stored in OIPA.

Request parameters

  • code (optional): Country code to search for.
  • name (optional): Country name to search for.
  • region_code (optional): Filter countries by Region code.
  • fields (optional): List of fields to display.
  • fields[aggregations] (optional): Aggregate available information. See Available aggregations section for details.

Available aggregations

API request may include fields[aggregations] parameter. This parameter controls result aggregations and can be one or more (comma separated values) of:

  • total_budget: Calculate total budget of activities presented in countries activities list.
  • disbursement: Calculate total disbursement of activities presented in countries activities list.
  • commitment: Calculate total commitment of activities presented in countries activities list.

Result details

Each result item contains short information about country including URI to country details.

URI is constructed as follows: /api/counties/{country_id}

GET /api/countries/
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 254,
    "next": "https://www.oipa.nl/api/countries/?page=2",
    "previous": null,
    "results": [
        {
            "url": "https://www.oipa.nl/api/countries/AC/",
            "code": "AC",
            "name": "Ascension Island"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AD/",
            "code": "AD",
            "name": "Andorra"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AE/",
            "code": "AE",
            "name": "United Arab Emirates (The)"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AF/",
            "code": "AF",
            "name": "Afghanistan"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AG/",
            "code": "AG",
            "name": "Antigua And Barbuda"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AI/",
            "code": "AI",
            "name": "Anguilla"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AL/",
            "code": "AL",
            "name": "Albania"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AM/",
            "code": "AM",
            "name": "Armenia"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AN/",
            "code": "AN",
            "name": "Netherland Antilles"
        },
        {
            "url": "https://www.oipa.nl/api/countries/AO/",
            "code": "AO",
            "name": "Angola"
        }
    ]
}