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=TN
{ "count": 20, "next": null, "previous": "https://oipa2018.unesco.org/api/activities/?recipient_country=TN", "results": [ { "url": "https://oipa2018.unesco.org/api/activities/37274/", "iati_identifier": "XM-DAC-41304-39-994", "title": { "id": 37274, "narratives": [ { "text": "Promoting gender equality in media, media diversity and MIL in the Maghreb countries", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37274, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This activity aims at supporting and promoting pluralistic media institutions and particularly gender equality in and within the media, as well as community media that reflect diversity of opinions and interests and represent all components of the society, in particular young people and women. Actions will also focus to empower youth and women through Media and Information Literacy (MIL) building upon and scaling up on the growing momentum around MIL in the Maghreb countries.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37274/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37427/", "iati_identifier": "XM-DAC-41304-39-1143", "title": { "id": 37427, "narratives": [ { "text": "Promote policy-research dialogue in the Arab region", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37427, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Arab social scientists and activists shared common concerns of the impact of the marginalized SHS in the education system and in societies during the regional consultations processes for the World Humanities Conference (Liege, Aug 2017). There is a need to enhance the role and relevance of social and human sciences in building resilience and critical thinking. Regional efforts will enhance the quality of teaching and research in social and human sciences knowledge, and bolster the use of humanities-based knowledge in policy-making.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37427/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37453/", "iati_identifier": "XM-DAC-41304-39-1174", "title": { "id": 37453, "narratives": [ { "text": "Support the documentary heritage preservation in the Maghreb through the MoW Programme and its normative framework", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37453, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This activity aims to supporting cluster countries in safeguarding, preserving , and making accessible its documentary heritage including via the active participation to the Memory of the World Programme (MOW) f.i. creating/revamping MOW national committees, creating MOW national registers, submitting quality candidatures to the MOW International register.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37453/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37484/", "iati_identifier": "XM-DAC-41304-39-1197", "title": { "id": 37484, "narratives": [ { "text": "Promoting universal access to information in the Maghreb through open and inclusive solutions and innovative use of ICTs for sustainable development", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37484, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This activity consists in supporting relevant institutions in the Maghreb in formulating policies and actions promoting Universal Access to Information and knowledge using ICTs, mobile devices and Open Solutions with special emphasis on teachers, learners, researchers, information professionals and/or scientists; including promoting Open Educational Resources (OER), Open Access, Free and Open Source Software (FOSS), ICT4ED, Open Data, as well as ICT accessibility including disabilities and multilingualism in the cyberspace.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37484/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37595/", "iati_identifier": "XM-DAC-41304-39-1342", "title": { "id": 37595, "narratives": [ { "text": "Regional campaigns on inclusive, peaceful and multicultural societies", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37595, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Many of the Maghreb countries have known political and social tensions, conflicts and wars in the recent years, which further undermines the culture of peace, diversity, rights and freedom. At the same time, some countries have undertaken important reforms to enshrine the universal principles in their political and institutional frameworks.\n\nUNESCO is called upon to facilitate evidence-based and multistakeholder dialogues, so that open public debates lead to political and social changes. To do so, Research-Advocacy-Policy linkages are of utmost importance. Advocacy, public awareness-raising and educational actions will be undertaken within this framework.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37595/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37673/", "iati_identifier": "XM-DAC-41304-39-1392", "title": { "id": 37673, "narratives": [ { "text": "La Science & l'Ingénierie au service du développement durable du Maghreb", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37673, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Le succès du Programme de développement durable à l'horizon 2030 dépend entre autres de la capacité de l'humanité à innover grâce aux domaines des STEM, mais aussi à éviter la fracture numérique entre les communautés. Les activités proposées visent à promouvoir les STEM au Maghreb à travers l'amélioration les méthodes de leur enseignement dès le jeune âge, améliorer l'introduction et l'accès aux technologies de l'Intelligence Artificielle en tant que levier de développement technologique dans la région et enfin, promouvoir le rôle des filles et femmes dans les domaines de la science.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37673/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37694/", "iati_identifier": "XM-DAC-41304-39-1402", "title": { "id": 37694, "narratives": [ { "text": "Towards the achievement of water-related SDGS in the Maghreb", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37694, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Au Maghreb, la sécurité hydrique est menacée sous l'effet conjugué de la rareté des ressources en eau, dictée par un contexte naturel défavorable, des activités humaines et du changement climatique qui a tendance à accentuer la raréfaction des ressources en eau et la fréquence et intensité des phénomènes extrêmes : sécheresses et inondations. Cette menace devrait être prise au sérieux par les gestionnaires du secteur de l'eau dans les pays du Maghreb. Les actions qui seront implémentées par le Bureau de l'UNESCO Maghreb visent à dresser un état des lieux du secteur de l'eau dans la région et contribuer au changement de paradigme à tous les niveaux à l'égard de l'eau, au renforcement des capacités et à l'adaptation des politiques hydriques aux contraintes internes et aux défis mondiaux.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37694/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37915/", "iati_identifier": "XM-DAC-41304-39-1614", "title": { "id": 37915, "narratives": [ { "text": ": National capacities in the Arab countries enhanced through regional approach", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37915, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "National stakeholders' attention and interest in ethics and human rights frameworks have considerably increased in the Arab region since the last decade. Nevertheless, the public's understanding and the use of specific tools in this domain remain limited, jeopardizing the long-term integration and effectiveness of the culture of rights and ethics. \n\nIn this context, UNESCO will aim at exploring a regional/ sub-regional approach in creating favourable conditions for the national institutions and stakeholders to mainstream the culture of rights and ethics in addressing social transformations, including at the city level.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37915/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37920/", "iati_identifier": "XM-DAC-41304-39-1619", "title": { "id": 37920, "narratives": [ { "text": "Youth civic engagement and youth-led social innovation supported in the Maghreb region", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37920, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Youth under 30 represent over 50% of population in the Arab region, while lacking space for participation and civic engagement. UNESCO contributes to the Regional UN Inter agency Framework of Joint Strategic Actions for Young People, supports youth leadership in peace-building, and promotes education-based efforts to prevent violent extremism, in compliance with UNSC Resolutions 2250 and 2354. In line with the 10th Youth Forum, UNESCO will establish a Regional Youth Space, support youth in protecting cultural heritage, and build youth's inter-cultural capacities. Partnerships will be intensified to accelerate youth's civic engagement in support of the implementation of the 2030 Agenda.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37920/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/38069/", "iati_identifier": "XM-DAC-41304-39-8815", "title": { "id": 38069, "narratives": [ { "text": "Capacity building for the Underwater Cultural Heritage Management for Sustainable Development in the Arab States", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 38069, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This activity will assist the capacity building for UCH management for sustainable development in the Arab States through the organization of the first Training of Trainers (ToT) to be held in Alexandria in 2020 as a follow up of the recommendations of the meeting of the Scientific and Technical Advisory Body (STAB) for the UCH Convention (Algeria, 2019). ToT will train UCH specialists from 5 member states in the Arab States to become a trainer for the future UCH workshops, building the foundation for the development of a regional capacity building programme. ToT will be organized in partnership with the Centre for Maritime Archaeology at Alexandria University which is a member of the UNITWIN network for maritime archaeology and ICOMOS UCH Committee.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/38069/transactions/" } ] }