Skip to content

IFRC DREF

The IFRC Disaster Relief Emergency Fund (DREF) provides immediate financial support to National Red Cross and Red Crescent Societies for early action and response to disasters and crises.

Collection Metadata

Data Sourcing

API Endpoints

  • Base URL: https://goadmin-stage.ifrc.org/api/v2/
  • Events Endpoint: /event/
  • Parameters:
    • dtype: Disaster type filter
    • appeal_type: Appeal type filter (0, 1 for DREF)
    • id: Specific event ID

Data Retrieval Process

  1. Events are filtered based on:
  2. Appeal type (DREF operations)
  3. Valid disaster type

  4. Presence of field reports

  5. For each event:

  6. Basic event information is extracted
  7. Impact data is collected from field reports
  8. Country information is used for geometry generation

Data Structure

Event Data Model

{
    "id": int,
    "name": str,
    "summary": str,
    "dtype": {
        "name": str  # Disaster type
    },
    "countries": [
        {
            "name": str,
            "iso3": str
        }
    ],
    "disaster_start_date": datetime,
    "appeals": [
        {
            "atype": int  # Appeal type (0, 1 for DREF)
        }
    ],
    "field_reports": [
        {
            "num_dead": int,
            "gov_num_dead": int,
            "other_num_dead": int,
            "num_injured": int,
            "gov_num_injured": int,
            "other_num_injured": int,
            # ... similar pattern for other impact metrics
        }
    ]
}

Accepted Disaster Types

  • Earthquake
  • Cyclone
  • Volcanic Eruption
  • Tsunami
  • Flood
  • Cold Wave
  • Fire
  • Heat Wave
  • Drought
  • Storm Surge
  • Landslide
  • Flash Flood
  • Epidemic

Item Mapping

Event Items

STAC Field IFRC Field Required Notes
id ifrcevent-event-{id} Yes Prefixed ID
geometry Generated Yes From country ISO3
datetime disaster_start_date Yes Start date of the disaster
title name Yes Event name
description summary No Event summary
start_datetime disaster_start_date Yes
end_datetime disaster_start_date Yes Same as start (no end date provided)

Monty Extension Fields

Field Source Notes
episode_number Fixed value (1) DREF doesn't track episodes
hazard_codes dtype.name Mapped to standard hazard codes
country_codes countries[].iso3 Array of ISO3 codes

Impact Items

Impact items are generated from field reports data, with multiple impact types:

Impact Type Source Fields Category
Death num_dead, gov_num_dead, other_num_dead ALL_PEOPLE
Displaced num_displaced, gov_num_displaced, other_num_displaced ALL_PEOPLE
Injured num_injured, gov_num_injured, other_num_injured ALL_PEOPLE
Missing num_missing, gov_num_missing, other_num_missing ALL_PEOPLE
Affected num_affected, gov_num_affected, other_num_affected ALL_PEOPLE
Assisted num_assisted, gov_num_assisted, other_num_assisted ALL_PEOPLE
Potentially Affected num_potentially_affected, gov_num_potentially_affected, other_num_potentially_affected ALL_PEOPLE
Highest Risk num_highest_risk, gov_num_highest_risk, other_num_highest_risk ALL_PEOPLE

Each impact type gets its own item with: - ID format: ifrcevent-impact-{event_id}-{impact_type} - Same geometry as parent event - Impact details including: - category (ALL_PEOPLE) - type (specific impact type) - value (first non-null value from the three source fields) - estimate_type (PRIMARY)

Hazard Type Mapping

IFRC DREF uses disaster type names and must follow the 2025 UNDRR-ISC code as the reference classification for the Monty extension:

IFRC Disaster Type GLIDE EM-DAT UNDRR-ISC 2025 (Reference) Cluster Description
Earthquake EQ nat-geo-ear-gro GH0101 GEO-SEIS Earthquake
Cyclone TC nat-met-sto-tro MH0306 MH-WIND Cyclone or Depression
Volcanic Eruption VO nat-geo-vol-vol GH0201 GEO-VOLC Lava Flows
Tsunami TS nat-geo-ear-tsu MH0705 MH-MARINE Tsunami
Flood FL nat-hyd-flo-flo MH0600 MH-WATER Flooding (chapeau)
Cold Wave CW nat-met-ext-col MH0502 MH-TEMP Cold Wave
Fire FR tec-ind-fir-fir TL0305 TECH-INDFAIL Fire (Industrial)
Heat Wave HT nat-met-ext-hea MH0501 MH-TEMP Heatwave
Drought DR nat-cli-dro-dro MH0401 MH-PRECIP Drought
Storm Surge SS nat-met-sto-sur MH0703 MH-MARINE Storm Surge
Landslide LS nat-geo-mmd-lan GH0300 GEO-GFAIL Gravitational Mass Movement
Flash Flood FF nat-hyd-flo-fla MH0603 MH-WATER Flash Flooding
Epidemic EP nat-bio-epi-dis BI0101 BIO-INFECT Infectious Diseases

Note

All three classification codes (GLIDE, EM-DAT, UNDRR-ISC 2025) should be included in the monty:hazard_codes array for maximum interoperability. More specific hazard codes can be added following the characteristics of the event. The 2025 update consolidated multiple earthquake-related HIPs into a single Earthquake HIP (GH0101), and reclassified Tsunami from Geological to Meteorological & Hydrological hazards.

This mapping enables standardized hazard categorization while preserving IFRC's original disaster type classification in the source properties.

Quality Control Notes

  1. Events are filtered to include only DREF operations
  2. Only events with valid disaster types are processed
  3. Impact values are cross-referenced between sources (government, other)
  4. Geometry is generated from country codes for consistent spatial representation