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 valuetotal_budget_value_gte(optional): Greater then or equal total budget valuetotal_child_budget_value_lte(optional): Less then or equal total child budget valuetotal_child_budget_value_gte(optional): Greater then or equal total child budget valueplanned_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.
Text search
API request may include q parameter. This parameter controls text search
and contains expected value.
By default, searching is performed on:
iati_identifierthe IATI identifiertitlenarrativesdescriptionnarrativesrecipient_countryrecipient country code and namerecipient_regionrecipient region code and namereporting_orgref and narrativessectorsector code and namedocument_linkurl, category and title narrativesparticipating_orgref 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:
titleplanned_start_dateactual_start_dateplanned_end_dateactual_end_datestart_dateend_dateactivity_budget_valueactivity_incoming_funds_valueactivity_disbursement_valueactivity_expenditure_valueactivity_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=LY
{ "count": 26, "next": "https://oipa2018.unesco.org/api/activities/?page=2&recipient_country=LY", "previous": null, "results": [ { "url": "https://oipa2018.unesco.org/api/activities/36352/", "iati_identifier": "XM-DAC-41304-901LIB2000", "title": { "id": 36352, "narratives": [ { "text": "Education and Training in Macromolecular Chemistry", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36352, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Project within the framework of the UNESCO-Libyan Funds in Trust Cooperation aimed at building national capacity and in particular that of the Centre for Macromolecular Chemistry and Technology in Tripoli, in the area of polymer chemistry and other areas of its expertise.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36352/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36354/", "iati_identifier": "XM-DAC-41304-901LIB2002", "title": { "id": 36354, "narratives": [ { "text": "Establishment of the Libyan National Seismological Network (LNSN)", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36354, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "The project consists of carrying out mutually agreed activities between UNESCO and the LCRSSS related to the \"Establishment of the Libyan Digital Seismological Network\" (LDSN). The LNSN network was designed to monitor local, regional and teleseismic activities, as well as to provide high quality data for research projects both locally and on the regional and global scale. The LNSN consists of 15 stations (3 very broadband and 12 broadband), utilizing state of the art VSAT communication technology, and a Central Processing Center, located in the City of Ghariyan, in addition to 13 portable stations. Building scientific capacities of Libyan specialists is a major component of the project. \n", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36354/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36356/", "iati_identifier": "XM-DAC-41304-901LIB2003", "title": { "id": 36356, "narratives": [ { "text": "Enhancing capacity of the Biotechnology Research Centre (BTRC)", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36356, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Launched in 2000 within the framework of the UNESCO-Libyan FIT cooperation, the project resulted in establishment of a Centre for Cell & Molecular Biology in Tripoli now the Biotechnology Research Centre (BTRC). The 1st phase centred on equipment & infrastructure needs. The new phase will lay emphasis on training and knowledge building. The main objective is to strengthen capacity of the BTRC & foster innovation in biotechnology in Libya.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36356/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36358/", "iati_identifier": "XM-DAC-41304-901LIB2043", "title": { "id": 36358, "narratives": [ { "text": "University of Benghazi", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36358, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "In 1981, an Agreement was signed between UNESCO and the Garyounis University. Both institutions agreed that UNESCO carries out specific activities on behalf of the University on a fund-in-trust basis. Within the framework of this cooperation, UNESCO will assist in providing services to Garyounis University. Thus, UNESCO will participate ensuring the right procurement of equipment, organizing training activities for Libyan specialists and technicians and appointing a resident expert as well as providing any other services that are deemed necessary.\n", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36358/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36539/", "iati_identifier": "XM-DAC-41304-901LIB2044", "title": { "id": 36539, "narratives": [ { "text": "National Academy for Scientific Research", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36539, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Project established within the framework of the UNESCO-Libyan Funds in Trust collaboration and which gave rise to a number of initiatives notably the Biotechnology Research and training centre (BTRC), the Marine Research Centre among others. Various consultations have been undertaken with the representatives of the Libyan Authorities notably the General Director of the National Academy for Scientific Research (NASR), now the Libyan Authority for Research in Science and Technology (LARST) on re-activating the cooperation between UNESCO and Libya in support to projects under the LARST, with the aim to cover a broader scope of activities in keeping with the needs of Libya today.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36539/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36542/", "iati_identifier": "XM-DAC-41304-901LIB2045", "title": { "id": 36542, "narratives": [ { "text": "Attahady University (Ex-Bright Star Univ", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36542, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "On 7 November 1983, UNESCO and the Bright Star University of Technology signedTechnology signed an agreement of cooperation. Within the term of the Agreement, UNESCO shall cooperate with the University in carrying out mutually agreed activities related to the overall development of the University.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36542/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36544/", "iati_identifier": "XM-DAC-41304-901LIB2046", "title": { "id": 36544, "narratives": [ { "text": "MARINE BIOLOGY RESEARCH CENTRE", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36544, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Main objectives and expected results: The MBRC had the following objectives:\n• Undertaking scientific research in the field of fish resources, and developing the technical expertise necessary to fulfill its aims and programmes.\n• Conducting marine surveys and taxonomic studies of biological populations existing in both the marine and lake waters.\n• Publishing the results of research and studies undertaken by the Centre, and producing scientific documentaries in this respect.\n• Cooperating with other relevant People's Committees and organizations in order to put the results of the researches and studies into scientific applications.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36544/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36546/", "iati_identifier": "XM-DAC-41304-901LIB2047", "title": { "id": 36547, "narratives": [ { "text": "MAN-MADE RIVER PROJECT- technical /training support", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36547, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "An agreement was signed between the MMRA and UNESCO in March 1990 for cooperation in carrying out mutually agreed activities related to the development of human resources for the operation and maintenance of the Man Made River Project. This includes but is not limited to a) Preparation of management structure including assessment of manpower requirements, qualifications, administrative and financial regulations and procedures, b) Training of technical managers, senior engineers, junior engineers, technicians and operators, c) Establishment of documentation centre and water information system, d) Extending support to the Authority during operation of the project as and when required", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36546/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36652/", "iati_identifier": "XM-DAC-41304-221RAB3000", "title": { "id": 36652, "narratives": [ { "text": "Prevention of Violent Extremism through Youth Empowerment in Jordan, Libya, Morocco and Tunisia - U&C", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36652, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "This project constitutes an effort to respond to an emerging global issue, and is being conceived as part of international actions to strengthen the positive role of young women and men in preventing and countering violent extremism and building lasting peace. The project, which adopts an inclusive, multi-sectoral approach across youth, education, culture, and communication and information, aims to create an environment where young women and men are empowered, heard and engaged as change-makers in their immediate communities to prevent violent extremism.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36652/transactions/" }, { "url": "https://oipa2018.unesco.org/api/activities/36749/", "iati_identifier": "XM-DAC-41304-901LIB4001", "title": { "id": 36750, "narratives": [ { "text": "Emergency intervention to secure museums and monuments in Libya", "language": { "code": "en", "name": "English" } } ] }, "descriptions": [ { "id": 36750, "type": { "code": "1", "name": "General" }, "narratives": [ { "text": "Contribute to the protection and promotion of the cultural heritage in Libya. Strengthen the technical and institutional capacities of the DoA /Ministry of Culture for the enhancement and protection of the cultural heritage in the country.", "language": { "code": "en", "name": "English" } } ] } ], "transactions": "https://oipa2018.unesco.org/api/activities/36749/transactions/" } ] }