The API endpoint is the following:
https://goadmin.ifrc.org/api/v2/surge_alert/
This table describes the main fields for each surge alert record in the results array
| Variable code | Data Type | Accept Null Values | Description |
|---|---|---|---|
id |
Integer | No | The unique identifier for the surge alert on the GO platform. |
created_at |
String (DateTime) | No | The date and time the alert was created on the GO platform. |
atype |
Integer | No | A numerical code representing the alert type (e.g., 6 for "rapid response"). |
atype_display |
String | No | The human-readable name for the alert type (e.g., "rapid response"). |
category |
Integer | No | A numerical code for the alert category (e.g., 2 for "alert"). |
category_display |
String | No | The human-readable name for the alert category. |
message |
String | No | A short, descriptive title for the surge alert message. |
operation |
String | Yes | The official operation name or code; can be an empty string. |
deployment_needed |
Boolean | No | A flag indicating if a physical deployment is required. |
is_private |
Boolean | No | A flag indicating if the alert is restricted or private. |
opens |
String (DateTime) | No | The date and time when the application period for the alert opens. |
closes |
String (DateTime) | Yes | The date and time when the application period closes; can be null if open-ended. |
start |
String (DateTime) | No | The planned start date for the deployment or mission. |
end |
String (DateTime) | No | The planned end date for the deployment or mission. |
molnix_id |
Integer | No | The identifier for this alert in the MolniX surge management system. |
molnix_status |
Integer | No | A numerical code for the alert's status in MolniX (e.g., 0 for Open, 2 for Closed). |
molnix_status_display |
String | No | The human-readable status of the alert (e.g., "Open", "Closed", "Stood Down"). |
country |
Object | No | An object containing details about the country where the surge is needed. |
event |
Object | Yes | An object containing details of the emergency event this alert is linked to; can be null. |
molnix_tags |
Array of Objects | No | A list of tag objects providing metadata like region, sector, language, and role. |
This table describes the fields for the country object linked to the alert
| Variable code | Data Type | Accept Null Values | Description |
id |
Integer | No | The unique identifier for the country. |
name |
String | No | The common name of the country (e.g., "Afghanistan"). |
society_name |
String | No | The official name of the Red Cross or Red Crescent National Society in that country. |
iso |
String | Yes | The 2-letter ISO 3166-1 alpha-2 country code (e.g., "AF"). |
iso3 |
String | Yes | The 3-letter ISO 3166-1 alpha-3 country code (e.g., "AFG"). |
region |
Integer | Yes | The numerical ID for the IFRC administrative region. |
fdrs |
String | Yes | The Federation-wide Databank and Reporting System code for the society. |
This table describes the fields within the event object (emergency event), if present
| Variable code | Data Type | Accept Null Values | Description |
id |
Integer | No | The unique identifier for the emergency event on the GO platform. |
name |
String | No | The official name of the emergency event. |
summary |
String (HTML) | Yes | A text or HTML summary describing the emergency situation. |
disaster_start_date |
String (DateTime) | No | The date the disaster began. |
ifrc_severity_level |
Integer | No | A numerical code for the IFRC's assessment of the disaster's severity (e.g., 1 for Orange). |
ifrc_severity_level_display |
String | No | The human-readable severity level (e.g., "Yellow", "Orange", "Red"). |
num_affected |
Integer | Yes | The estimated number of people affected by the disaster. |
glide |
String | Yes | The GLIDE (GLobal IDEntifier) number for the disaster event; can be an empty string. |
dtype |
Object | No | A nested object describing the disaster type (e.g., "Population Movement"). |
countries |
Array of Objects | No | A list of all countries affected by this event. |
appeals |
Array of Objects | No | A list of funding appeals associated with this event. |
This table describes the fields for the objects found within the molnix_tags array
| Variable code | Data Type | Accept Null Values | Description |
id |
Integer | No | The unique identifier for the tag on the GO platform. |
molnix_id |
Integer | No | The identifier for this tag in the MolniX system. |
name |
String | No | The short name or code for the tag (e.g., "OPS-LEAD", "L-ENG"). |
description |
String | No | A brief description of what the tag represents (e.g., "Operational Leadership", "English"). |
tag_type |
String | No | The classification of the tag (e.g., "regular", "language"). |
groups |
Array of Strings | No | A list of groups the tag belongs to, used for categorization (e.g., "SECTOR", "LANGUAGE") |
event: You can filter the table through a general search (besides to the event name field, the search would be done in the operation and message field) e.g.: https://goadmin.ifrc.org/api/v2/surge_alert/?search=Afghanistan%20Humanitarian%20Crisesoperation: You can filter the table through a general search (besides to the operation field, the search would be done in the event and message fields) e.g.: https://goadmin.ifrc.org/api/v2/surge_alert/?search=Uganda%20Ebola%20Outbreakmessage: You can filter the table through a general search (besides to the message field, the search would be done in the event and operation fields) e.g.: https://goadmin.ifrc.org/api/v2/surge_alert/?search=im%20coordinator