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/?reporting_organisation_identifier=US-EIN-042347643
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 5,
    "next": null,
    "previous": null,
    "results": [
        {
            "url": "https://yoda.oipa.nl/api/activities/1450636/",
            "iati_identifier": "US-EIN-042347643-6063",
            "title": {
                "id": 1450281,
                "narratives": [
                    {
                        "text": "AgResults:  Innovation in Research and Delivery External Impact Evaluation (Global)",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 1568715,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "AgResults is a new multilateral initiative seeking to enhance smallholder welfare and improve food security through the use of \"pull\" mechanisms.  The scope of the external impact evaluation is to:  1) Define a compelling and coherent impact evaluation framework for the AgResults Initiative; 2) Design impact evaluations for 5-6 pilots; 3) Design, implement and analyze field surveys for 3 pilots; 4) Assist as needed in the communication of the learning agenda, impact evaluation strategy and evaluations results; and 5) Participate in steering committee meetings as and when required.;",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/1450636/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/1450641/",
            "iati_identifier": "US-EIN-042347643-6504",
            "title": {
                "id": 1450284,
                "narratives": [
                    {
                        "text": "AgDevCo:  Impact Evaluation of African Agricultural Development Company (AgDevCo)",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 1568718,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "Impact Evaluation of African Agricultural Development Company (AgDevCo) investments in five African countries through country catalytic funds, regional impact investments, and a growth corridor fund (for Beira in Mozambique). An important evaluation task is to assess the relevance, effectiveness and performance of the patient capital investment fund model and whether it is filling a critical gap in agribusiness finance and able to catalyze additional agribusiness investment through a demonstration effect.  \r\n;",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/1450641/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/1450643/",
            "iati_identifier": "US-EIN-042347643-ZambiaSUFP",
            "title": {
                "id": 1450287,
                "narratives": [
                    {
                        "text": "Scaling Up Family Planning - Zambia",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 1568721,
                    "type": {
                        "code": "2",
                        "name": "Objectives"
                    },
                    "narratives": [
                        {
                            "text": "Scaling Up Family Planning (SUFP) in Zambia is a four -year Department for International Development (DFID) funded program that aims to contribute to reducing maternal mortality and increasing contraceptive prevalence in Zambia through expanding access to family planning services.\t\t\r\n;",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/1450643/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/1450646/",
            "iati_identifier": "US-EIN-042347643-200708080/PO4048",
            "title": {
                "id": 1450289,
                "narratives": [
                    {
                        "text": "Partnership For Transforming Health Services 2 (PATHS 2) Nigeria",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 1568723,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Partnership for Transforming Health Services, Phase 2 (PATHS2), a DFID-funded program in Nigeria, aims to improve the planning, financing and delivery of sustainable and replicable pro-poor health services for common health problems, focusing on five states and the federal government.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/1450646/transactions/"
        },
        {
            "url": "https://yoda.oipa.nl/api/activities/1450647/",
            "iati_identifier": "US-EIN-042347643-5859",
            "title": {
                "id": 1450291,
                "narratives": [
                    {
                        "text": "External Impact Evaluation of AgResults: Innovation in Research and Delivery",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 1568725,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "AgResults is amultilateral initiative seeking to enhance smallholder welfare and improve food security through the use of \"pull\" mechanisms. The scope of the external impact evaluation is to: 1) Design impact evaluations for 2 pilots; 2) Design, implement and analyze field surveys for 4 pilots; 3) Assist as needed in the communication of the learning agenda, impact evaluation strategy and evaluations results; and 4) Participate in steering committee meetings as and when required.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "https://yoda.oipa.nl/api/activities/1450647/transactions/"
        }
    ]
}