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=KZ
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 17,
    "next": "https://oipa2018.unesco.org/api/activities/?page=2&recipient_country=KZ",
    "previous": null,
    "results": [
        {
            "url": "https://oipa2018.unesco.org/api/activities/35825/",
            "iati_identifier": "XM-DAC-41304-570INT1004",
            "title": {
                "id": 35825,
                "narratives": [
                    {
                        "text": "IITE-UNESCO Associated Schools Network pilot project for Shanghai Cooperation Organization countries",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35825,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The aim of this Project is to harness the potential of Information and Communication Technologies (ICT), particularly interactive and online tools, to enhance teaching, learning and inter-cultural dialogue so that young people become active learners, knowledge constructors and global citizens to participate fully in society.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35825/transactions/"
        },
        {
            "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/36537/",
            "iati_identifier": "XM-DAC-41304-728RAS2000",
            "title": {
                "id": 36537,
                "narratives": [
                    {
                        "text": "Formulation of the PFG: Reducing vulnerabilities of populations in the Central Asia region from GLOFs in a changing climate",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 36537,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The objective of the Project Formulation Grant (PFG) is to develop the full-size project \"Reducing vulnerabilities of populations in the Central Asia region from glacier lake outburst floods in a changing climate\". The project aims to strengthen adaptation to climate change in Central Asia by reducing societal risks and vulnerabilities associated with GLOFs. It will enhance monitoring, analytical and response capacities of institutions and government officials responsible for DRR, emergencies and CCA, through community and gender-sensitive ground-level training and awareness campaigns, and through the establishment of EWS, supported with the necessary state-of-the-art monitoring strategies.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/36537/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37081/",
            "iati_identifier": "XM-DAC-41304-39-835",
            "title": {
                "id": 37081,
                "narratives": [
                    {
                        "text": "Strengthening education policy, planning and monitoring to provide equitable and quality lifelong-learning in Central Asia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37081,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Central Asian countries have been facing challenges to implement SDG4 in regards to policy and planning. Challenges in the achievement of SDG4 are related to monitoring of education data that requires further attention. To assess and to closely monitor the performance of education systems, education management systems need to be strengthened and resources need to be distributed equitably. In response to this need, UNESCO Almaty will provide Member States with policy advice, technical and capacity building support in preparing evidence-based education strategies and plans, and conducting quality monitoring with a SDG4 perspective, while focusing on TVET, non-formal education, higher education, ICT in education and ESD, especially for girls and women.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37081/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37093/",
            "iati_identifier": "XM-DAC-41304-39-844",
            "title": {
                "id": 37093,
                "narratives": [
                    {
                        "text": "Strengthening competences through Education for Sustainable Development and Global Citizenship",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37093,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Even though the sub-region advanced on the achievement of SDGs, it has a way to go in the achievement of all SDG 4 targets to \"ensure inclusive and equitable quality education and promote lifelong learning opportunities for all\", especially SDG target 4.7. UNESCO will provide support to strengthening the quality and relevance of education and competency-based learning for youth and adults through the development of curriculum, pedagogical materials and pre-service and in-service teacher training modules and courses, accompanied by capacity development for teacher education institutions and teachers on ESD, GCED, PVE, MIL and healthy lifestyles in Central Asia in line with the new global framework on Education for Sustainable Development (ESD for 2030) for the period of 2020-2030.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37093/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37336/",
            "iati_identifier": "XM-DAC-41304-39-1058",
            "title": {
                "id": 37336,
                "narratives": [
                    {
                        "text": "Improve the state of conservation and management at World Heritage properties in Central Asia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37336,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "CA cluster countries under the Almaty Office require further capacity development in WH management and strengthening coordination. \n The specific focus areas are: \n- strengthen capacity of local authorities, departments responsible for WH site management, planning and tourism development, \n- foster cooperation and networking in CA at central, province and district levels. \nSpecific objectives: \n- Technical advise, support for conservation, management, implementation of the WH Committee Decisions and heritage based tourism development,\n- Capacity-building initiatives at national and sub-regional levels, \n- Enhance cooperation, constructive dialogue at national levels with all line ministries, state and private bodies, scientific experts, and sub-regional level in CA.\n",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37336/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37361/",
            "iati_identifier": "XM-DAC-41304-39-1077",
            "title": {
                "id": 37361,
                "narratives": [
                    {
                        "text": "Initiatives to safeguard intangible cultural heritage through formal and non-formal education for education quality improvement in Central Asia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37361,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "One of the two key priorities in the field of ICH for the period 2018-2021 is safeguarding ICH in formal and non-formal education. As a follow up to the recent series of capacity building activities implemented in Central Asia and two pilot studies on availability of ICH related programmes in TVET and secondary schools, the Almaty Cluster Office will continue engage the four countries, under its responsibility, in activities focusing on safeguarding intangible cultural heritage through formal and non-formal education.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37361/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37385/",
            "iati_identifier": "XM-DAC-41304-39-1104",
            "title": {
                "id": 37385,
                "narratives": [
                    {
                        "text": "Capacity development initiatives for the promotion and implementation of the 2005 Convention in Central Asia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37385,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The 2005 Convention still has low ratification rates in CA. Uzbekistan in 2019 ratified the Convention. Now Tajikistan and Uzbekistan ratified the Convention. There is a strong interest in the CCI from the civil society.\nThe following needs for CA: \n• Increase knowledge on the Convention and IA,\n• Strengthen capacities to promote the ratification and the implementation. \n• Awareness-raising and networking opportunities. \nThe Office will continue to assist countries to encourage the development of partnerships at the national and sub-regional levels. Following specific objectives will be in focus: \n- Technical advise to State Parties\n- Capacity-building initiatives on promotion of CCI \n- Situation analysis on Film industry in CA\n- Awareness-raising on the Convention and IA.\n",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37385/transactions/"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/37551/",
            "iati_identifier": "XM-DAC-41304-39-1319",
            "title": {
                "id": 37551,
                "narratives": [
                    {
                        "text": "Fostering freedom of expression and press, right to information and safety of journalists in Central Asia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 37551,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "UNESCO Almaty Communication and Information Programme will contribute to SDG 16.10 strengthen freedom of expression and press, right to information and safety of journalists by complex activities including gender mainstreaming using multi-stakeholder cooperation and member states ranking ambitions.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/37551/transactions/"
        },
        {
            "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/"
        }
    ]
}