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=KH
{ "count": 22, "next": "https://oipa2018.unesco.org/api/activities/?page=3&recipient_country=KH", "previous": "https://oipa2018.unesco.org/api/activities/?recipient_country=KH", "results": [ { "url": "https://oipa2018.unesco.org/api/activities/35646/", "iati_identifier": "XM-DAC-41304-570RAS1003", "title": { "id": 35646, "narratives": [ { "text": "Optimizing Assessment for All", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 35646, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The Optimizing Assessment for All (\"OAA\") project is designed to support countries to improve the assessment, teaching, and learning of 21st century skills. This is a collaborative effort between the Network on Education Quality Monitoring in the Asia Pacific (NEQMAP) at UNESCO Bangkok and the Center of Universal Education (\"CUE\") at Brookings. The project will engage three countries in the Asia-Pacific region including Cambodia, Mongolia, and Nepal to develop understanding of the nature of 21st century skills in order to develop assessment approaches that are usable and interpretable by classroom teachers.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/35646/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/35904/", "iati_identifier": "XM-DAC-41304-727CMB1005", "title": { "id": 35904, "narratives": [ { "text": "Cambodia GPE-III Implementation Agency Fees", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 35904, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Support cost for the Cambodia GPE-III implementation.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/35904/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/35982/", "iati_identifier": "XM-DAC-41304-221CMB1000", "title": { "id": 35982, "narratives": [ { "text": "Decent Employment for Youth In Cambodia (DEY)", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 35982, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Capitalizing on the comparative advantages, complementary mandates and areas of expertise as well as resources of four United Nations agencies, namely ILO, UNESCO, UNICEF and UNIDO, the \"Decent Employment for Youth in Cambodia\" programme phase 2 is designed to address these key strategic gaps in building skills and education in Cambodia. The programme intends to support young women and men in Cambodia to increasingly obtain decent and productive employment opportunities by ensuring they are better able to meet labour market demand and are prepared for quality employment. UNESCO will be leading the section on BEEP and FLP. The duration of the programme is 4 years from 2020 - 2023.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/35982/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36381/", "iati_identifier": "XM-DAC-41304-728RAS2001", "title": { "id": 36380, "narratives": [ { "text": "Project Formulation - Groundwater Resources in Greater Mekong Sub-region: Collaborative Management to Increase Resilience", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36380, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This project formulation grant activity has as its primary purpose to develop a full-scale project document for submission to the Adaptation Fund. In turn, the full-scale project has the overarching objective to establish effective regional capacities, partnerships and networks in the Greater Mekong Subregion (Vietnam, Lao PDR, Cambodia, Thailand and Myanmar) for the sustainable management and utilization of groundwater resources as an adaptation response to protect people, livelihoods and ecosystems from climate change impacts.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36381/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37518/", "iati_identifier": "XM-DAC-41304-39-1278", "title": { "id": 37518, "narratives": [ { "text": "ICC-Angkor", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37518, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "As the follow-up of the decision of the First ICC-Angkor, held in Tokyo in 1993, the working procedures of the Committee were established. It was decided that the Committee would be co-chaired by France and Japan in collaboration with the APSARA Authority, UNESCO provides the Secretariat. It was reconfirmed by the Angkor International Conference recently held in Cambodia on 5/12/2013 where the French and Japan co-Chairs have re-endorsed their co-chairmanship.\nThe financial mechanism established on the initiative of Japan and France also foresaw that the cost of the ICC-Angkor meetings should be borne by these two countries and UNESCO.Since 2009 the APSARA National Authority has also financially contributed to the ICC-Angkor meetings. Its contribution has been increasing ever since.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37518/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37765/", "iati_identifier": "XM-DAC-41304-39-1468", "title": { "id": 37765, "narratives": [ { "text": "Inclusive and participatory public policy in Asia and the Pacific", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37765, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Building on work from 2018-2019, UNESCO will continue to support research and policy development in the areas of youth development, sport, internal migration, disability and sustainability. science, especially through city-led action, with resources from the regular budget. The two focus areas are building the Asia Pacific Coalition of Cities Against Discrimination (regional) and its work on internal migration (Southeast Asia) and the ASEAN Sustainability Science initiative (Southeast Asia)", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37765/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37770/", "iati_identifier": "XM-DAC-41304-39-1473", "title": { "id": 37770, "narratives": [ { "text": "Skills for social inclusion, peace building and intercultural dialogue through MOST, bioethics, sport and youth activities", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37770, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Building on work from 2018-2019, UNESCO will continue to support capacity development for social transformations. The main areas of focus will be on intercultural dialogue through expanding use of Writing Peace; and strengthening social science institutions in Mekong countries, though MOST schools and technical assistance.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37770/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/37772/", "iati_identifier": "XM-DAC-41304-39-1474", "title": { "id": 37772, "narratives": [ { "text": "Networking for peace building and strengthening social transformation", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 37772, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "UNESCO will promote the SDGs and social transformation through advocacy by youth and sporting federations. These organisations each play a critical role in the future of their communities and have the ability to foster long term behavior change. Through building youth advocacy platforms, UNESCO can assist vulnerable youth networks such as the disabled and ethnic minorities. Sporting organisations can play a powerful role in creating spaces for dialogue and social cohesion.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/37772/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/38123/", "iati_identifier": "XM-DAC-41304-39-8896", "title": { "id": 38123, "narratives": [ { "text": "Enhancing Employment Opportunities for Women and Youth through Literacy and Basic Education", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 38123, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Within the framework of the Lifelong Learning Policy of the Royal Government of Cambodia, UNESCO will support the expansion of the Factory Literacy Programme (FLP) and the Basic Education Equivalency Programme (BEEP), jointly implemented by the Ministry of Education, Youth and Sport and the Ministry of Labour and Vocational Training. The linkage between the two programmes will open wider access to non-formal learning opportunities among women and out-of-school youth.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/38123/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/38430/", "iati_identifier": "XM-DAC-41304-39-12104", "title": { "id": 38430, "narratives": [ { "text": "Culture Heritage Education", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 38430, "type": { "code": "1", "name": "General" }, "narratives": [] } ], "transactions": "https://oipa2018.unesco.org/api/activities/38430/transactions/" } ] }