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/
HTTP 200 OK
						Allow: GET, HEAD, OPTIONS
						Content-Type: application/json
						Vary: Accept
						
					{
    "count": 1500,
    "next": "http://dev.oipa.nl/api/activities/?page=2",
    "previous": null,
    "results": [
        {
            "url": "http://dev.oipa.nl/api/activities/1/",
            "iati_identifier": "XM-DAC-41304-170GLO4038",
            "title": {
                "id": 1,
                "narratives": [
                    {
                        "text": "Fund of the 1970 Convention on the Means of Prohibiting and Preventing the Illicit Import, Export and Transfer of Ownership of Cultural Property",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 1,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The purpose of this Special Account is to support the 1970 Convention through the allocation of resources to reinforce its operational implementation (capacity-building, outreach and communication, inventorying and monitoring of sales) and contributing to the participation of representatives from developing countries in sessions of the Meeting of States Parties and its Subsidiary Committee. A planned budget for the use of the resources of the Fund will be prepared by the Secretariat for the consideration and approval of the Meeting of States Parties for each biennium. \n",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/1/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/2/",
            "iati_identifier": "XM-DAC-41304-181GLO3000",
            "title": {
                "id": 2,
                "narratives": [
                    {
                        "text": "FUND FOR THE ELIMINATION OF DOPING IN SPORT - EDUCATION PROJECTS FOCUSING ON YOUTH AND SPORTS ORGANISATIONS",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 2,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Fund for the Elimination of Doping in Sport was established, in 2008, to assist all States Parties with the development and implementation of anti-doping programmes consistent with the Convention. This Fund, established to build anti-doping capacity around the world, can help finance national and regional anti-doping projects in the areas of: (1) education; (2) policy advice; and (3) capacity development.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/2/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/3/",
            "iati_identifier": "XM-DAC-41304-181GLO3001",
            "title": {
                "id": 3,
                "narratives": [
                    {
                        "text": "FUND FOR THE ELIMINATION OF DOPING IN SPORT - PROVISION OF ANTI-DOPING POLICY ADVICE TO STATES PARTIES",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 3,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Fund for the Elimination of Doping in Sport was established, in 2008, to assist all States Parties with the development and implementation of anti-doping programmes consistent with the Convention. This Fund, established to build anti-doping capacity around the world, can help finance national and regional anti-doping projects in the areas of: (1) education; (2) policy advice; and (3) capacity development.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/3/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/4/",
            "iati_identifier": "XM-DAC-41304-181GLO3002",
            "title": {
                "id": 4,
                "narratives": [
                    {
                        "text": "FUND FOR THE ELIMINATION OF DOPING IN SPORT - DEVELOPMENT OF MENTORING AND CAPACITY BUILDING PROGRAMMES",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 4,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Fund for the Elimination of Doping in Sport was established, in 2008, to assist all States Parties with the development and implementation of anti-doping programmes consistent with the Convention. This Fund, established to build anti-doping capacity around the world, can help finance national and regional anti-doping projects in the areas of: (1) education; (2) policy advice; and (3) capacity development.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/4/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/5/",
            "iati_identifier": "XM-DAC-41304-181GLO3038",
            "title": {
                "id": 5,
                "narratives": [
                    {
                        "text": "Fund for the Elimination of Doping in Sport - Implementation of the International Convention against Doping in Sport (Approval Committee) 2016-2017",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 5,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Fund for the Elimination of Doping in Sport was established in 2008 to assist States Parties to the International Convention against Doping in Sport develop and implement anti-doping programmes consistent with the Convention. The Fund can finance national and regional anti-doping projects in the areas of: (1) education; (2) policy advice; and (3) capacity development.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/5/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/6/",
            "iati_identifier": "XM-DAC-41304-181GLO3039",
            "title": {
                "id": 6,
                "narratives": [
                    {
                        "text": "Fund for the Elimination of Doping in Sport 2018-2019",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 6,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The Fund for the Elimination of Doping in Sport was established in 2008 to assist States Parties to the International Convention against Doping in Sport develop and implement anti-doping programmes consistent with the Convention. The Fund can finance national and regional anti-doping projects in the areas of: (1) education; (2) policy advice; and (3) capacity development.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/6/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/7/",
            "iati_identifier": "XM-DAC-41304-181RUS3038",
            "title": {
                "id": 7,
                "narratives": [
                    {
                        "text": "Policy advice project: review of the Russian Federation anti-doping policy",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 7,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "COP4 approved Resolution 4CP/7 to conduct a national review of national anti-doping public policy and legal framework. During COP5, the international consultant recommended to \"continue evaluation missions supplemented by support missions when appropriate and mobilization of the UNESCO fund for the implementation of public policies\". Following the extraordinary meeting of the Bureau (Aug 2016), the Bureau recommended that a review be conducted in the Russian Federation based on the methodology of the project carried out previously. The PAP in the Russian Federation should lead to a follow-up action plan after the presentation of the conclusions made by the team of consultants to COP6.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/7/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/8/",
            "iati_identifier": "XM-DAC-41304-181RUS3039",
            "title": {
                "id": 8,
                "narratives": [
                    {
                        "text": "Policy advice project: review of the Russian Federation anti-doping policy 2018-2019",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 8,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "In August 2016, the Bureau of the Conference of Parties recommended that a review be conducted in the Russian Federation based on the methodology presented at the Fifth Session of the Conference of Parties. The review of the anti-doping policy of the Russian Federation started in 2017 and the results were presented during the Sixth Session of the Conference of Parties (25-26 September 2017). In 2018-2019, the project will focus on the action plan presented at COP6 (Resolution 6CP/8). A report will be presented to COP7 in 2019.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/8/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/9/",
            "iati_identifier": "XM-DAC-41304-182GLO4038",
            "title": {
                "id": 9,
                "narratives": [
                    {
                        "text": "International Fund for Cultural Diversity",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 9,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The International Fund for Cultural Diversity (IFCD) is a multi-donor fund established under Article 18 of the 2005 Convention on the Protection and Promotion of the Diversity of Cultural Expressions. Its purpose is to promote sustainable development and poverty reduction in developing countries that are Parties to the 2005 Convention.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/9/transactions/"
        },
        {
            "url": "http://dev.oipa.nl/api/activities/10/",
            "iati_identifier": "XM-DAC-41304-182GLO4039",
            "title": {
                "id": 10,
                "narratives": [
                    {
                        "text": "International Fund for Cultural Diversity 39C/5",
                        "language": {
                            "code": "en",
                            "name": "English"
                        }
                    }
                ]
            },
            "descriptions": [
                {
                    "id": 10,
                    "type": {
                        "code": "1",
                        "name": "General"
                    },
                    "narratives": [
                        {
                            "text": "The International Fund for Cultural Diversity (IFCD) is a multi-donor fund established under Article 18 of the 2005 Convention on the Protection and Promotion of the Diversity of Cultural Expressions. Its purpose is to promote sustainable development and poverty reduction in developing countries that are Parties to the 2005 Convention.",
                            "language": {
                                "code": "en",
                                "name": "English"
                            }
                        }
                    ]
                }
            ],
            "transactions": "http://dev.oipa.nl/api/activities/10/transactions/"
        }
    ]
}