Activity List

Returns a list of IATI Activities stored in OIPA.

Request parameters

  • activity_id (optional): Comma separated list of activity id's.
  • activity_scope (optional): Comma separated list of iso2 country codes.
  • recipient_country (optional): Comma separated list of iso2 country codes.
  • recipient_region (optional): Comma separated list of region codes.
  • sector (optional): Comma separated list of 5-digit sector codes.
  • sector_category (optional): Comma separated list of 3-digit sector codes.
  • reporting_organisation_identifier (optional): Comma separated list of reporting organisation IATI identifiers.
  • participating_organisation (optional): Comma separated list of organisation id's.
  • total_budget_value_lte (optional): Less then or equal total budget value
  • total_budget_value_gte (optional): Greater then or equal total budget value
  • total_child_budget_value_lte (optional): Less then or equal total child budget value
  • total_child_budget_value_gte (optional): Greater then or equal total child budget value
  • planned_start_date_lte (optional): Date in YYYY-MM-DD format, returns activities earlier or equal to the given activity date.
  • planned_start_date_gte (optional): Date in YYYY-MM-DD format, returns activities later or equal to the given activity date.
  • actual_start_date_lte (optional): Date in YYYY-MM-DD format, returns activities earlier or equal to the given activity date.
  • actual_start_date_gte (optional): Date in YYYY-MM-DD format, returns activities later or equal to the given activity date.
  • planned_end_date_lte (optional): Date in YYYY-MM-DD format, returns activities earlier or equal to the given activity date.
  • planned_end_date_gte (optional): Date in YYYY-MM-DD format, returns activities later or equal to the given activity date.
  • actual_end_date_lte (optional): Date in YYYY-MM-DD format, returns activities earlier or equal to the given activity date.
  • actual_end_date_gte (optional): Date in YYYY-MM-DD format, returns activities later or equal to the given activity date.
  • activity_status (optional): Comma separated list of activity statuses.
  • hierarchy (optional): Comma separated list of activity hierarchies.
  • related_activity_id (optional): Comma separated list of activity ids. Returns a list of all activities mentioning these activity id's.
  • related_activity_type (optional): Comma separated list of RelatedActivityType codes.
  • related_activity_recipient_country (optional): Comma separated list of iso2 country codes.
  • related_activity_recipient_region (optional): Comma separated list of region codes.
  • related_activity_sector (optional): Comma separated list of 5-digit sector codes.
  • related_activity_sector_category (optional): Comma separated list of 3-digit sector codes.
  • transaction_provider_activity (optional): Comma separated list of activity id's.
  • transaction_date_year (optional): Comma separated list of years in which the activity should have transactions.
  • transactionbalance_total_budget_gte (optional): Greater then or equal transaction balance of the total budget.
  • transactionbalance_total_budget_lte (optional): Less then or equal transaction balance of the total budget.
  • transactionbalance_total_expenditure_gte (optional): Greater then or equal transaction balance of the total expenditure.
  • transactionbalance_total_expenditure_lte (optional): Less then or equal transaction balance of the total expenditure.

API request may include q parameter. This parameter controls text search and contains expected value.

By default, searching is performed on:

  • iati_identifier the IATI identifier
  • title narratives
  • description narratives
  • recipient_country recipient country code and name
  • recipient_region recipient region code and name
  • reporting_org ref and narratives
  • sector sector code and name
  • document_link url, category and title narratives
  • participating_org ref and narratives

To search on subset of these fields the q_fields parameter can be used, like so; q_fields=iati_identifier,title,description

By default, search only return results if the hit resembles a full word. This can be altered through the q_lookup parameter. Options for this parameter are:

  • exact (default): Only return results when the query hit is a full word.
  • startswith: Also returns results when the word stars with the query.

Ordering

API request may include ordering parameter. This parameter controls the order in which results are returned.

Results can be ordered by:

  • title
  • planned_start_date
  • actual_start_date
  • planned_end_date
  • actual_end_date
  • start_date
  • end_date
  • activity_budget_value
  • activity_incoming_funds_value
  • activity_disbursement_value
  • activity_expenditure_value
  • activity_plus_child_budget_value
  • 'transactionbalance_total_budget`
  • 'transactionbalance_total_expenditure'

The user may also specify reverse orderings by prefixing the field name with '-', like so: -title

Aggregations

At the moment there's no direct aggregations on this endpoint.

The /activities/aggregations endpoint can be used for activity based aggregations.

Result details

Each item contains summarized information on the activity being shown, including the URI to activity details, which contain all information. To show more information in list view the fields parameter can be used. Example; fields=activity_id,title,country,any_field.

GET /api/activities/?recipient_country=KP
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 22,
    "next": "https://oipa2018.unesco.org/api/activities/?page=2&recipient_country=KP",
    "previous": null,
    "results": [
        {
            "url": "https://oipa2018.unesco.org/api/activities/35354/",
            "iati_identifier": "XM-DAC-41304-526DRK4002",
            "title": {
                "id": 35354,
                "narratives": [
                    {
                        "text": "Preservation of Koguryo Tombs and Mural Paintings in the Democratic People's Republic of Korea (Phase IV)",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35354,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Following the success of Phases I to III of the FiT project to preserve Koguryo-era tombs in the Democratic People' s Republic of Korea, this fourth phase will focus on scientific research and documentation on the tombs' mural paintings and emergency on-site conservation activities, along with training to further reinforce national capacities in the field of conservation. Coordinated by the World Heritage Centre, in close co-operation with the UNESCO Beijing Office and the Permanent Delegation of the DPRK, the project involves international experts from different fields and focuses on two tombs located within the World Heritage property, the Jinpa-ri Tombs I and IV.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35354/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36343/",
            "iati_identifier": "XM-DAC-41304-526RAS2012",
            "title": {
                "id": 36343,
                "narratives": [
                    {
                        "text": "Biodiversity research, training and management in the Democratic People's Republic of Korea",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36343,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The project seeks to assist the DPRK biodiversity research and management community to update its knowledge and understanding of the state of the country's biodiversity with particular reference to rare and endangered species. The project will facilitate the delivery of support to the DPRK National MAB Committee for research activities designed in consultation with UNESCO and drawing on the contributions not only of DPRK's own research community but also that of other member countries of the East Asian Biosphere Reserve Network (EABRN).",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36343/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36391/",
            "iati_identifier": "XM-DAC-41304-526RAS2015",
            "title": {
                "id": 36391,
                "narratives": [
                    {
                        "text": "EABRN 2019-2020",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36391,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The East Asian Biosphere Reserve Network (EABRN) is a regional network supporting the MAB Programme and was initially established with 3 priority themes for cooperation: eco-tourism, conservation policy, and transboundary cooperation. EABRN was officially launched in 1995 by China, the Democratic People's Republic of Korea (DPRK), Japan, Mongolia and the Republic of Korea (ROK), which were joined by the Russian Federation in 1998 and Kazakhstan in 2011. The overall goal/objective of the project is to support a strong and active network of well-managed BRs across the seven EABRN member countries, actively engaging exchanges on management, research and local development.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36391/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36912/",
            "iati_identifier": "XM-DAC-41304-39-725",
            "title": {
                "id": 36912,
                "narratives": [
                    {
                        "text": "Localization of SDG4-ED2030 at Country level",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36912,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "In response to the needs of the Cluster Countries, UNESCO Beijing will build and strengthen capacity of Ministries of Education and Institutions to strategically promote and coordinate with education stakeholders to deepen the localization and implementation of SDG4-ED2030 agenda at country level. The localization process will ensure alignment and monitor policies, strategies and sector plans with the SDG4 targets. UNESCO Beijing will work with Ministries of Education and stakeholders to support policy dialogue, Capacity development, advocacy and sharing best practices and models to institutionalize SDG4 at country level and mainstream SDG4 targets in education sector plans at country level and aligned with UN Sustainable Development Cooperation Framework (UNSDCF).",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36912/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36916/",
            "iati_identifier": "XM-DAC-41304-39-728",
            "title": {
                "id": 36917,
                "narratives": [
                    {
                        "text": "Strengthening quality TVET programme at Country level",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36917,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "UNESCO Beijing will strengthen national capacity, promote best practices in skills development, TVET reform, TVET policy reviews and dialogue, TVET qualifications framework and student mobility, greening TVET, TVET Recommendation, and enhance knowledge sharing via the UNEVOC Centres in the Cluster Countries guided by the SDG8,SDG4.3-ED 2030 agenda principles highlighted in the 2012 Shanghai Consensus on TVET and UNSDCF. Partner with stakeholders development partners, UN Agencies to strengthen policy dialogue on the role of TVET to support youth transitioning from school to world of work, skills for work and life, promote strategies aligned with needs of labour market and policy alignment line Ministries in Cluster countries (China, DPRK, Japan, Mongolia and ROK).",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36916/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36920/",
            "iati_identifier": "XM-DAC-41304-39-730",
            "title": {
                "id": 36920,
                "narratives": [
                    {
                        "text": "Strengthening Lifelong learning and Non-Formal Education at country level",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36920,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "In response to needs of Cluster Countries, UNESCO will build and strengthen institutional capacity of formal and non-formal education institutions to implement and promote lifelong learning within the CONFINTEA VI, Belem Framework for Action and SDG4.6 and ED-2030 agenda. and focused sharply on Lifelong learning policy, research, community education, capacity development, knowledge sharing and advocacy and awareness raised. Enhanced capacity of Community Learning Centres to deliver skills training, in rural and urban communities. Expand the number of CLCs. Literacy and lifelong learning challenges shall be targetted in partnership with UN Agencies, Development Partners and Donors aligned with the UN Sustainable Development Cooperation Framework (UNSDF) in China, Mongolia and DPRK..",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36920/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36924/",
            "iati_identifier": "XM-DAC-41304-39-732",
            "title": {
                "id": 36924,
                "narratives": [
                    {
                        "text": "Strengthening quality of higher education at country level",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36924,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "In response to needs of Cluster countries UNESCO will build and strengthen institutional capacity of tertiary institutions to provide quality graduates aligned to labour market needs.Facilitate policy dialogue to reform higher education sector in the context of SDG4.3-ED 2030 agenda, sharpen focus on lifelong learning, policy reviews, ODL, recognition of qualifications, accreditation, student mobility,quality assurance and ratification of regional and new global convention in recognition of qualifications.UNESCO will strengthen mechanisms for inter-university collaboration, knowledge sharing of best practices and partnerships through UNESCO Chairs/UNITWIN programme to foster north-south-south dialogue and cooperation among tertiary institutions in the Cluster Countries.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36924/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36926/",
            "iati_identifier": "XM-DAC-41304-39-733",
            "title": {
                "id": 36926,
                "narratives": [
                    {
                        "text": "Strengthening Education for Sustainable Development at country level",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36926,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "In response to the needs of Cluster Countries UNESCO will strengthen capacity of Ministries of Education and national institutions to scale-up implementation of ESD -GAP Phase II (2020-2030), GCED and health education at all levels to provide learners and experts with the knowledge, skills, values, attitudes and behaviors needed to live healthy lives, promote sustainable development and act as responsible global citizens, and advance the agenda on SDG 13, 15 & SDG4.7 and 4.a, and contribute to the other SDGs related to health, sustainable consumption and climate change. ESD-GAP Phase (2020-30) will be reinforced and implemented and inter-sectorial collaboration initiative on heritage education platform will be implemented in Cluster Countries.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36926/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36930/",
            "iati_identifier": "XM-DAC-41304-39-735",
            "title": {
                "id": 36930,
                "narratives": [
                    {
                        "text": "Conservation, promotion and sustainable management of World Heritage sites in Mongolia, DPRK, and China",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36930,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "With the challenges posed by modernization, globalization, urbanization and rapid economic development, there is a need to strengthen efforts to protect the cultural and natural heritage of Northeast Asia. Through capacity-building, Mongolia, DPRK and China will be supported in their endeavors to operationalize the provisions of the UNESCO 1972 Convention at the national and local levels, in order to improve the conservation and sustainable management of World Heritage sites. As part of this strategy, education activities through innovative approaches to World Heritage Education will continue to sensitize young people, foster youth engagement, and promote heritage values as a pilot project in Mongolia.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36930/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/36934/",
            "iati_identifier": "XM-DAC-41304-39-738",
            "title": {
                "id": 36934,
                "narratives": [
                    {
                        "text": "Strengthening the capacities of Northeast Asian countries for the safeguarding of intangible cultural heritage",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36934,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Since the ratification of the UNESCO 2003 Convention, Northeast Asian countries have been active in its effective implementation at the national level and have substantially increased their human and institutional capacities through technical support and capacity-building provided by past UNESCO interventions. Building on the enhanced capacities, the cluster countries, with a focus on Mongolia and DPRK, will be supported in integrating intangible cultural heritage into their plans, policies and programmes, in particular as contribution towards the achievement of SDGs. Focus areas will be the incorporation of ICH in formal and non-formal education in Mongolia and the effective utilization of the Intangible Cultural Heritage Fund in DPRK to complement national safeguarding efforts.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36934/transactions/"
        }
    ]
}