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/?format=api&recipient_country=BD
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 22,
    "next": "https://oipa2018.unesco.org/api/activities/?format=api&page=2&recipient_country=BD",
    "previous": null,
    "results": [
        {
            "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/34971/?format=api",
            "iati_identifier": "XM-DAC-41304-727BGD1000",
            "title": {
                "id": 34971,
                "narratives": [
                    {
                        "text": "Education Sector Analysis towards developing an Education Sector Plan for Bangladesh",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 34971,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Ministry of Primary and Mass Education and Ministry of Education of Bangladesh is developing Education Sector Plan (ESP) for achieving SDG4. In order to develop the ESP, Education Sector Analysis will be conducted. To support this process, UNESCO Bangladesh is nominated as the Grant Agent of the ESPDG of GPE, with the responsibilities of leading the ESPDG application, supporting in conducting the ESA and ESP development with MOPME and MOE as the lead and ELCG as the coordinating platform.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/34971/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35042/?format=api",
            "iati_identifier": "XM-DAC-41304-408GLO5002",
            "title": {
                "id": 35042,
                "narratives": [
                    {
                        "text": "Freedom of Expression: Media Pluralism and Diversity",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35042,
                    "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/35042/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35175/?format=api",
            "iati_identifier": "XM-DAC-41304-526RAS4019",
            "title": {
                "id": 35175,
                "narratives": [
                    {
                        "text": "Strengthening regional and national capacities to develop cultural and creative industries for the diversity of cultural expressions in Asia/Pacific",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35175,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The project aims at strengthening national and regional capacities to develop cultural and creative industries for the diversity of cultural expressions in Asia and Pacific and raising awareness of the importance of the cultural and creative industries (CCI) for sustainable development. \n• Component 1: Building capacities of specialists in Asia and Pacific on the 2005 Convention\n• Component 2: Empowering creative entrepreneurs and raising awareness about the importance of CCI for sustainable development in Pakistan\n• Component 3: Strengthening national capacities to develop and promote visual arts (photography) in Bangladesh: contributing to sustainable development\n",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35175/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35413/?format=api",
            "iati_identifier": "XM-DAC-41304-BGD0112092",
            "title": {
                "id": 35413,
                "narratives": [
                    {
                        "text": "Enhancing climate resilience to heritage sites in coastal region of Bangladesh",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35413,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Climate change is being considered as becoming as the biggest risk to cultural heritage around the globe . The need to protect them is acknowledged in target 11.4 of the Sustainable Development Goals (SDGs), which aims to \"strengthen efforts to protect and safeguard the world's cultural and natural heritage\", as well as in GCF's Performance Standard Nr. 8 for 'Cultural Heritage'. This proposed project targets 18 cultural heritage sites (including UNESCO WH) in southwest Bangladesh, which are the most exposed to salinization and cyclones and will be jointly implemented by the DoA, under the Ministry of Cultural Affairs,UNESCO,IDCOL and UNDP.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35413/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35542/?format=api",
            "iati_identifier": "XM-DAC-41304-503GLO4001",
            "title": {
                "id": 35542,
                "narratives": [
                    {
                        "text": "Reshaping cultural policies for the promotion of fundamental freedoms and the diversity of cultural expressions",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35542,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "This project aims to raise the level and quality of knowledge and bridge capacity gaps on the 2005 Convention through the capacity development interventions on policy monitoring, information and data collection, indicator building involving a diverse stakeholders in 16 developing countries, and the production of a 3rd edition of the Global Report (planned publication in June 2021). It is expected that governmental and non-governmental actors will work together to better highlight effective policies and strategies that promote fundamental freedoms. This will serve to support evidenced-based policy, also strengthening transparent, participatory and democratic systems of governance.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35542/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35764/?format=api",
            "iati_identifier": "XM-DAC-41304-727BGD1001",
            "title": {
                "id": 35764,
                "narratives": [
                    {
                        "text": "Education Sector Analysis towards developing an Education Sector Plan for Bangladesh",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35764,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Ministry of Primary and Mass Education and Ministry of Education of Bangladesh is developing Education Sector Plan (ESP) for achieving SDG4. In order to develop the ESP, Education Sector Analysis will be conducted. To support this process, UNESCO Bangladesh has been selected as the Grant Agent of the ESPDG, thus assuming a number of responsibilities including leading the ESPDG application, supporting in conducting ESA and coordination of the ESP development process, and administrating the ESPDG.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35764/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35874/?format=api",
            "iati_identifier": "XM-DAC-41304-554RAS1017",
            "title": {
                "id": 35874,
                "narratives": [
                    {
                        "text": "ICT to Facilitate SDG4 in South Asia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35874,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "This project provides technical assistance to four South Asian Member States to build national capacity in developing and implementing relevant policies to integrate ICT in education to facilitate the achievement of the SDG4 targets. it includes three components: 1) development of a comprehensive and costed ICT in Education Master Plan, 2) enhancement of competency standards and corresponding curriculum for teacher training, and 3) facilitation of sub-regional knowledge-exchange opportunities.\n",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35874/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35914/?format=api",
            "iati_identifier": "XM-DAC-41304-201BGD1000",
            "title": {
                "id": 35914,
                "narratives": [
                    {
                        "text": "Quality Education for Rohingya Refugees and Host Communities in Cox's Bazar",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35914,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Since 25 August 2017, over 700,000 Rohingya refugees were forced across Myanmar border into Cox's Bazar, Bangladesh to escape violence in Rakhine State. While Cox's Bazar is the lowest performing district in Bangladesh in education access, retention and achievement, hosting over 900,000 refugees, it faces severe challenges in education for both refugee and host communities. ECW thus provides US$12m from its Multi-Year Resilience Window for support to quality education for approximately 183,000 direct beneficiaries, comprising of 79,250 refugee and host community children and youth, 2,000 teachers, 101,500 community members and 300 education officials through UNICEF, UNESCO and UNHCR.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35914/transactions/?format=api"
        },
        {
            "url": "https://oipa2018.unesco.org/api/activities/35980/?format=api",
            "iati_identifier": "XM-DAC-41304-567RAS1001",
            "title": {
                "id": 35980,
                "narratives": [
                    {
                        "text": "Learning for Empathy*: the Teacher Exchange and Support Programme for Bangladesh, Indonesia, Pakistan and Sri Lanka in cooperation with Japan",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 35980,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The project will provide secondary general education school and madrassa teachers in the 4 countries and Japan with an opportunity for mutual learning on how they try to make learning more motivating, meaningful and empowering in the era of SDGs. It will support their efforts in revisiting teaching practices for promoting peace, tolerance and interfaith/intercultural harmony in the society. The project will continue sharing good practices with a wider community of ED stakeholders in Asia-Pacific and beyond in mainstreaming SDG4.7 as a key entry point to living together in diversity as a way to prevent conflict, hatred, radicalization, and violent extremism.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://oipa2018.unesco.org/api/activities/35980/transactions/?format=api"
        }
    ]
}