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.

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
  • other_identifier owner ref and narratives
  • contact_info all narratives for organisation, department, person name, job title & mailing address
  • location ref of location
  • country_budget_items narrative of budget item description
  • policy_marker narratives of policy marker
  • transaction ref and narratives of description, provider organisation, receiver organisation
  • related_activity ref of related activity
  • conditions narratives of condition
  • result narratives for result title, result description, result indicator title, result indicator description, result indicator period target comment, result indicator perioda ctual comment

To search on subset of these fields the q_fields parameter can be used, like so; q_fields=iati_identifier,title,description

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

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/
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 1076605,
    "next": "https://yoda.oipa.nl/api/activities/?page=2",
    "previous": null,
    "results": [
        {
            "url": "https://yoda.oipa.nl/api/activities/243763/",
            "iati_identifier": "US-EIN-941655673-40506",
            "title": {
                "id": 243712,
                "narratives": [
                    {
                        "text": "\"for general operating support\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248637,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"The Guttmacher Institute conducts scientific inquiry to produce policy-relevant research on key issues relating to sexual and reproductive health. The institute continues to build the evidence for policy changes that promote sexual and reproductive health, and carry out a program of social science research, policy analysis, and public education.*Conflict Footnote\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243763/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243764/",
            "iati_identifier": "US-EIN-941655673-40167",
            "title": {
                "id": 243713,
                "narratives": [
                    {
                        "text": "\"for general operating support\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248638,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"The International Budget Partnership (IBP) leads a global civil society movement to use budget analysis and advocacy to improve governance and reduce poverty. IBP invests in the capacity of citizens to understand and analyze public budgets, participate in budget processes, and advocate for policies and reforms that make government more transparent, accountable, and responsive to the needs and priorities of citizens, especially the poor and marginalized. IBP also promotes budget policies that are based on fair taxation.*Conflict Footnote\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243764/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243765/",
            "iati_identifier": "US-EIN-941655673-40615",
            "title": {
                "id": 243714,
                "narratives": [
                    {
                        "text": "\"for the Center for Budget and Economic Governance\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248639,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"Advocates Coalition for Development and Environment (ACODE) conducts independent research and analysis of public spending in Uganda, advocates for evidence-based public policies, and builds citizens’ capacity to use data to demand accountability and improved services from government. During this grant period, ACODE will deepen its research on fiscal governance and continue its work to promote citizen-government engagement. ACODE will also use results from the Local Government Councils Scorecard Initiative to foster government responsiveness by raising awareness about the availability and quality of public services.\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243765/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243766/",
            "iati_identifier": "US-EIN-941655673-40313",
            "title": {
                "id": 243715,
                "narratives": [
                    {
                        "text": "\"for general operating support\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248640,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"The Center for Global Development is an independent, nonpartisan think tank that works to reduce global poverty and improve lives through economic research that drives better policy and practice by the world’s top decision makers. The center’s research and policy engagement are structured around five program areas: U.S. and U.K. development policy initiatives; global health policy; migration, displacement, and humanitarian policy; sustainable development finance; and technology and development. The center has headquarters in Washington, D.C., and a London-based Europe office.\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243766/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243767/",
            "iati_identifier": "US-EIN-941655673-40343",
            "title": {
                "id": 243716,
                "narratives": [
                    {
                        "text": "\"for support to strengthen impact evaluation capacities in East and West Africa\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248641,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"The Partnership for Economic Policy provides funding to researchers in low- and middle-income countries, and mentoring and training to help build research and policy engagement skills. With this grant, the partnership will support researchers in East and West Africa that conduct impact evaluation of government programs. Additionally, it will provide technical support to East and West African governments interested in conducting impact evaluations.\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243767/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243769/",
            "iati_identifier": "US-EIN-941655673-40600",
            "title": {
                "id": 243718,
                "narratives": [
                    {
                        "text": "\"for general operating support\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248643,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"The African Population and Health Research Center aims to generate scientific knowledge to inform local development priorities, and cultivate the next generation of African researchers and thought leaders engaged in evidence-driven change. The center produces policy-oriented research, builds its research capacity-strengthening programs, and refines how it engages in decision-making processes. The center also works to enhance its geographical reach in West and Central Africa. \"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243769/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243770/",
            "iati_identifier": "US-EIN-941655673-40599",
            "title": {
                "id": 243719,
                "narratives": [
                    {
                        "text": "\"for support of Population Services International's Francophone West Africa program\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248644,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"This project seeks to reduce maternal mortality due to unsafe abortion in Francophone West Africa. Population Services International will use insights about women’s preferences to increase reproductive health options and use commercial marketing techniques to promote new products in several countries in West Africa. It will also test innovative models that require less infrastructure to distribute reproductive health products and look for opportunities to provide alternatives for women who otherwise would seek a clandestine abortion.\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243770/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243772/",
            "iati_identifier": "US-EIN-941655673-40573",
            "title": {
                "id": 243720,
                "narratives": [
                    {
                        "text": "\"for support to the Ouagadougou Partnership Coordination Unit\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248645,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"IntraHealth International hosts the Coordination Unit of The Ouagadougou Partnership in Senegal.  The Ouagadougou Partnership is a collaboration among eight donors and the nine Francophone countries in West Africa to increase family planning use. Its Coordination Unit convenes donors, organizes exchange visits among countries, represents the partnership at a global level, and facilitates an annual meeting. During the grant period, the Coordination Unit will intensify efforts to coordinate donor investments at the country level, identify new champions to advocate for family planning, and continue to raise funds for family planning in Francophone West Africa. \"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243772/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243774/",
            "iati_identifier": "US-EIN-941655673-40414",
            "title": {
                "id": 243722,
                "narratives": [
                    {
                        "text": "\"for a program to support open public contracting in East and West Africa\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248647,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"for a program to support open public contracting in East and West Africa\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243774/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/243775/",
            "iati_identifier": "US-EIN-941655673-40558",
            "title": {
                "id": 243723,
                "narratives": [
                    {
                        "text": "\"for support of the Right to Information Program\"",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 248648,
                    "type": null,
                    "narratives": [
                        {
                            "text": "\"for support of the Right to Information Program\"",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/243775/transactions/"
        }
    ]
}