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=KR
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 9,
    "next": null,
    "previous": null,
    "results": [
        {
            "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/37380/",
            "iati_identifier": "XM-DAC-41304-39-1097",
            "title": {
                "id": 37380,
                "narratives": [
                    {
                        "text": "Fostering an inclusive and participatory public policy environment",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37380,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Building inclusive societies depends on evidence-based policies that promote state obligations to respect, protect and fulfil human rights. It also requires that the voices and concerns of vulnerable and marginalized groups are captured in research and utilized in decision and policymaking processes that concern them.\nUNESCO will support Members and stakeholders in the region to improve multidisciplinary, multistakeholder policymaking through a research-policy interface, informed by social science research and knowledge on women, including the social situation of elderly women. Research will also be encouraged, through the GSRN to Women, Peace and Security (WPS) tailoring policy to the North-East Asia sub-region.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37380/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37395/",
            "iati_identifier": "XM-DAC-41304-39-1112",
            "title": {
                "id": 37395,
                "narratives": [
                    {
                        "text": "Youth upfront",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37395,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Fostering youth engagement & inclusion is essential for building inclusive & equitable societies and for ensuring well-rounded transition to adulthood. During remaining years of Operational Strategy on Youth (2014-2021) will focus on youth-led activities & meaningful engagement of youth in planning, development & execution of youth-relevant initiatives.\n\nBeijing will engage with youth on two complementary levels: (a) acting as an enabler & working with young agents of change to scale up their outstanding youth-led initiatives to address societal challenges and consolidate peace; (b) meaningfully engage with youth as partners in co-shaping and co-delivering UNESCO's work.\n\nEmphasis will be placed on youth participation in UN75 Dialogues initiatives.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37395/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/38168/",
            "iati_identifier": "XM-DAC-41304-39-8976",
            "title": {
                "id": 38168,
                "narratives": [
                    {
                        "text": "EABRN and MAB Youth engagement in Biodiversity Conservation",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 38168,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The East Asian Biosphere Reserve Network (EABRN) is a regional network supporting the MAB Programme and was established in 1995 to develop cooperation along 3 main axes: eco-tourism, conservation policy, and transboundary cooperation. The main purpose of the present work plan is to support a strong and active network of well-managed BRs across the seven EABRN member countries, actively engaging in exchanges on management, research and local development. Particular attention will also be dedicated to engaging with Mab Youth in the region and worldwide, with the main purpose of offering them a unique opportunity to elaborate their contribution to the CBD COP 15 debates and foster their commitment to contribute to biodiversity conservation and climate action beyond 2020.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/38168/transactions/"
        }
    ]
}