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/?format=api&page=2
{ "count": 2150, "next": "https://oipa2018.unesco.org/api/activities/?format=api&page=3", "previous": "https://oipa2018.unesco.org/api/activities/?format=api", "results": [ { "url": "https://oipa2018.unesco.org/api/activities/34903/?format=api", "iati_identifier": "XM-DAC-41304-263RAS1000", "title": { "id": 34903, "narratives": [ { "text": "Social Protection Programme", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34903, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Funded by the Joint SDG Fund, the UN Joint Social Protection Programme covers Samoa, Cook Islands, Niue & Tokelau. The objective is to develop evidence based nationally owned social protection (SP) systems to accelerate SDGs through integrated programming in national and sub-national development. The Programme actions are along the following outcome areas: data/evidence, public finance, institutional coordination, partnerships and outreach. UNESCO's portion of the work covers all outcome areas for the persons with disabilities (PWDs).", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34903/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34905/?format=api", "iati_identifier": "XM-DAC-41304-408FOE5040", "title": { "id": 34905, "narratives": [ { "text": "Multi-Donor Programme on Freedom of Expression and Safety of Journalists - ER1", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34905, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "A Multi Donor Programme on Freedom of Expression and Safety of Journalists, was approved by the Executive Board, in its 200th session (Decision 19), to help facilitate UNESCO's work to implement the Programme of the Organization's Communication and Information Sector, as outlined in the C/5, under Expected Result 1 (Member States have adopted and/or applied relevant policies and normative frameworks to strengthen the environment for freedom of expression, press freedom and safety of journalists). \n\nFunds also contribute to the achievement of ER 2. (Freedom of Expression: Media Pluralism and Diversity).", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34905/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34907/?format=api", "iati_identifier": "XM-DAC-41304-408MAS5040", "title": { "id": 34907, "narratives": [ { "text": "Special Account Freedom of Expression and Security of Journalists - Outcome 2", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34907, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This is a programme open to multiple donors wishing to support pluralism and diversity in media. It targets SDGs 4, 5, 13.a, 16 and 17. It particulary assists Member States to ensure pluralism by promoting community media as part of the essential mix of public, private and non-profit media. The account also covers gender equality in both media operations and content, youth media production as well as empowering citizens with increased media and information literacy (MIL) competencies. Support to actions concerning media in crisis and emergency situations are also foreseen through this Account, such as terrorism and the media, media and migration, climate change and the media, etc.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34907/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34909/?format=api", "iati_identifier": "XM-DAC-41304-410GLO1000", "title": { "id": 34909, "narratives": [ { "text": "Special Account on Education for Health and Well-Being", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34909, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The Special Account supports the implementation of the UNESCO Strategy on Education for Health and Well-being, which covers the 2016-2021 period. The Strategy focuses on two strategic priorities: \n1) Young people benefit from quality comprehensive sexuality education that includes HIV Prevention\n2) Young people have access to safe, inclusive, health promoting learning environments", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34909/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34912/?format=api", "iati_identifier": "XM-DAC-41304-459GLO1001", "title": { "id": 34912, "narratives": [ { "text": "Global Education Monitoring Report", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34912, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The Global Education Monitoring Report (or GEM Report), formerly known as the EFA Global Monitoring Report (GMR), is an editorially independent, authoritative, and evidence-based annual report that monitors progress towards the global education goal and targets adopted by the international community in 2015, as part of the new Sustainable Development Goals (SDGs). With its renewed mandate in 2015, and drawing on accumulated expertise, the GEM Report team will launch a new series of internationally focused education monitoring reports starting in 2016. These reports will analyze global education trends and advocate for effective education policies and practice in the next decade and beyond.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34912/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34914/?format=api", "iati_identifier": "XM-DAC-41304-467GLO1006", "title": { "id": 34915, "narratives": [ { "text": "CapEFA Programme Management & Technical Backstopping", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34915, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "CapEFA Programme Management & Technical Backstopping", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34914/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34917/?format=api", "iati_identifier": "XM-DAC-41304-467GLO1012", "title": { "id": 34917, "narratives": [ { "text": "CapED Programme - Fostering Skills for Life and Work: Youth employment and entrepreneurship", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34917, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The CapED Programme is an extrabudgetary programme created in 2003. It is based on the understanding that education reforms will not be effective if countries lack the capacities to make them operational. With an overarching capacity development approach, CapED seeks to improve the quality of education and increase learning opportunities, especially for girls and women and disadvantaged population groups. Under \"Youth employment and entrepreneurship\", CapED will develop capacities across the system to create better coordination and linkages between TVET provision and the labour market and to facilitate more efficient and equitable transition to work.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34917/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34919/?format=api", "iati_identifier": "XM-DAC-41304-467GLO1013", "title": { "id": 34919, "narratives": [ { "text": "CapED Programme - Improving Quality through Teachers", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34919, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The CapED Programme is an extrabudgetary programme created in 2003. It is based on the understanding that education reforms will not be effective if countries lack the capacities to make them operational. With an overarching capacity development approach, CapED seeks to improve the quality of education and increase learning opportunities, especially for girls and women and disadvantaged population groups. Under \"Improving Quality through Teachers\", CapED supports countries develop and implement comprehensive teacher policies, strengthen teacher-training institutions and ensure that programmes for the professional development of teachers are reviewed from a gender-equality perspective.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34919/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34922/?format=api", "iati_identifier": "XM-DAC-41304-469GLO2004", "title": { "id": 34922, "narratives": [ { "text": "The Carlos J. Finlay Prize for Microbiology", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34922, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The purpose of the Carlos J. Finlay UNESCO Prize for Microbiology is to reward an individual, institution, or other entity or non-governmental organization who, through research and development, has made an outstanding contribution to the field of microbiology (including immunology, molecular biology, genetics, etc.) and its applications throughout the world. The objective of the Prize is in conformity with UNESCO's policies and is related to the Programme of the Organization in the field of promoting scientific research.\n", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34922/transactions/?format=api" }, { "url": "https://oipa2018.unesco.org/api/activities/34924/?format=api", "iati_identifier": "XM-DAC-41304-495GLO1026", "title": { "id": 34924, "narratives": [ { "text": "40C/5-ER 6: National capacities strengthened to equip learners with knowledge, skills, values and attitudes needed to live healthy lives, promote sustainable development and engage with the world as responsible global citizens", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 34924, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "National capacities strengthened to equip learners with knowledge, skills, values and attitudes needed to live healthy lives, promote sustainable development and engage with the world as responsible global citizens", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/34924/transactions/?format=api" } ] }