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 valuetotal_budget_value_gte(optional): Greater then or equal total budget valuetotal_child_budget_value_lte(optional): Less then or equal total child budget valuetotal_child_budget_value_gte(optional): Greater then or equal total child budget valueplanned_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.
Text search
API request may include q parameter. This parameter controls text search
and contains expected value.
By default, searching is performed on:
iati_identifierthe IATI identifiertitlenarrativesdescriptionnarrativesrecipient_countryrecipient country code and namerecipient_regionrecipient region code and namereporting_orgref and narrativessectorsector code and namedocument_linkurl, category and title narrativesparticipating_orgref 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:
titleplanned_start_dateactual_start_dateplanned_end_dateactual_end_datestart_dateend_dateactivity_budget_valueactivity_incoming_funds_valueactivity_disbursement_valueactivity_expenditure_valueactivity_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/?page=2&recipient_country=TJ
{ "count": 17, "next": null, "previous": "https://oipa2018.unesco.org/api/activities/?recipient_country=TJ", "results": [ { "url": "https://oipa2018.unesco.org/api/activities/37578/", "iati_identifier": "XM-DAC-41304-39-1332", "title": { "id": 37578, "narratives": [ { "text": "Media diversity in Central Asia", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37578, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "UNESCO Almaty Communication and Information Programme will contribute to SDG 16.10 strengthen communities media diversity, gender equality, youth empowerment with media and information literacy by complex activities using multi-stakeholder cooperation in Kyrgyzstan, Kazakhstan, Tajikistan and Uzbekistan.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37578/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37601/", "iati_identifier": "XM-DAC-41304-39-1348", "title": { "id": 37601, "narratives": [ { "text": "Open solutions in Central Asia", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37601, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "UNESCO Almaty Communication and Information Programme will contribute to six SDG including 10.2 by by open access and complex activities through multi-stakeholder cooperation. UNESCO will support Central Asian States in developing long-term strategies to scale up access to the necessary 21st century technology skills.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37601/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37903/", "iati_identifier": "XM-DAC-41304-39-1603", "title": { "id": 37903, "narratives": [ { "text": "Enhancing Water Security and Cooperation in Central Asia", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37903, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Central Asia (CA) is experiencing increasing water stress due to changing demand for water, population growth and demand for food security. Shared water resources in the region and the predicted impacts of climate change on the glacial sources of the major rivers, further exacerbate the challenges. Water is at the heart of the socio-economic development and SDG6 is pivotal for most of the other SDGs. Water cooperation is therefore an enabling factor for sustainable economic development and stability in the region. Improving water management is essential to meet the needs of the countries to achieve SDG6. The activity will address water security challenges in CA through advanced research, education, capacity building and cooperation among water experts, policy makers, communities and youth", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37903/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37909/", "iati_identifier": "XM-DAC-41304-39-1612", "title": { "id": 37909, "narratives": [ { "text": "Promote Geohazard Risk Reduction, as well as Geosciences and Geological Heritage in Central Asia", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37909, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Central Asia (CA) region is vulnerable to various risks from geohazards. It is also very reach in diverse geology, but with very weak capacities in geosciences and limited knowledge on geological heritage and its use for sustainable development of communities and regions. Therefore this activity, capitalizing on scientific knowledge and best expertise on geohazard risk reduction and on geosciences, will have dual focus: 1. Enhancing resilience of populations in CA region, especially the most vulnerable, from geohazards and 2. Promotion of geosciences and knowledge on geological heritage for sustainable geotourism development and for ultimate establishment of aspiring UNESCO Global Geoparks.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37909/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/38225/", "iati_identifier": "XM-DAC-41304-39-9069", "title": { "id": 38225, "narratives": [ { "text": "Promoting ethics education in Central Asia for sustainable development", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 38225, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "UNESCO supports Member States in reinforcement of their capacities in the area of ethics education since it becomes an integral part of promoting knowledge-based, sustainable and equitable development. Central Asia is not an exception. The rapidly expanding knowledge in every area of inquiry, and especially in life and biological sciences, is continuously pushing the limits of what people can do. However, ethics education in Central Asia is still undervalued but it is a well-known fact that the quality of ethics education largely depends on the substantive and pedagogic competences of the teacher. An effective ethics teacher should be knowledgeable about how to teach, as well as what to teach to the students.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/38225/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/38226/", "iati_identifier": "XM-DAC-41304-39-9070", "title": { "id": 38226, "narratives": [ { "text": "Empowerment of young women and men from rural and remote areas of Central Asia through youth-led action and promotion of sports", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 38226, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "In Central Asia there could be traced a global trend of increasing demographic share of the youth vis-à-vis general population, what could speak about the urgency of elaborating and implementing special programmes and initiatives on youth development. It is also important to consider that in Central Asia there is a rather high percentage of rural youth, which also indicates the need to ensure equal access to quality education, scientific, cultural and social life of both groups in order to avoid the development of discrimination, marginalization and radicalization of the latter. This activity aims to empower young people from rural and remote areas of Central Asia to tackle numerous challenges on their way to peacebuilding.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/38226/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/38227/", "iati_identifier": "XM-DAC-41304-39-9071", "title": { "id": 38227, "narratives": [ { "text": "Fostering intercultural dialogue for peacebuilding and social inclusion in Central Asia", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 38227, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Despite the fact that Central Asia actively pursue a policy of tolerance and harmony, there is still a threat of ethnic conflicts, in particular between vulnerable youth groups over the social and economic opportunities. The uneven distribution of the population also leads to tense inter-ethnic relations, mostly affecting young migrants. Interethnic conflicts are also consequences of inequalities in education, job opportunities,lack of cultural orientation and criminalization of youth who unsuccessfully moved from rural areas to the cities. This activity aims at improvement of intercultural competences among young people in order to improve their human interactions across differences, whether within a society or across borders through capacity-building, advocacy and youth-led actions.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/38227/transactions/" } ] }