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

Region List

Returns a list of IATI Regions stored in OIPA.

Request parameters

  • 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 regions activities list.
  • disbursement: Calculate total disbursement of activities presented in regions activities list.
  • commitment: Calculate total commitment of activities presented in regions activities list.

Result details

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

URI is constructed as follows: /api/regions/{region_id}

GET /api/regions/
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 17,
    "next": "https://oipa.nl/api/regions/?page=2",
    "previous": null,
    "results": [
        {
            "url": "https://oipa.nl/api/regions/189/",
            "code": "189",
            "name": "North of Sahara, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/289/",
            "code": "289",
            "name": "South of Sahara, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/298/",
            "code": "298",
            "name": "Africa, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/380/",
            "code": "380",
            "name": "West Indies, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/389/",
            "code": "389",
            "name": "North & Central America, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/489/",
            "code": "489",
            "name": "South America, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/498/",
            "code": "498",
            "name": "America, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/589/",
            "code": "589",
            "name": "Middle East, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/619/",
            "code": "619",
            "name": "Central Asia, regional"
        },
        {
            "url": "https://oipa.nl/api/regions/679/",
            "code": "679",
            "name": "South Asia, regional"
        }
    ]
}