> For the complete documentation index, see [llms.txt](https://api-v2-docs.disasteraware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-v2-docs.disasteraware.com/hazards/hazard-samples/marine-sample.md).

# Marine Sample

This page provides a complete sample response for a marine hazard from the Active Hazards API endpoint. Marine hazards are coastal and offshore weather warnings — special marine warnings, gale and storm warnings for marine zones — issued by national meteorological services under the Common Alerting Protocol (CAP). The sample below is an Environment Canada special marine warning for waters north of Tuktoyaktuk.

## Marine-Specific Properties

### Incident Data

The `incident.properties` object for a marine hazard contains standard CAP alert metadata. Key incident properties include:

* `senderName` / `sender` - Issuing agency (e.g., `"Environment Canada"`) and CAP sender address
* `event` - Event type name (e.g., `"Special Marine"`)
* `headline` / `headlineDescription` - Alert headline and combined headline-plus-description text
* `description` - Detailed alert text
* `severity` / `urgency` / `certainty` - CAP classification values. Multi-valued alerts join them with commas (e.g., `"Immediate, Past"`)
* `effective` / `onset` / `expires` - ISO 8601 alert window
* `sent` - Send time in epoch milliseconds
* `msgType` / `status` / `scope` / `category` - CAP message metadata
* `identifier` / `references` - CAP identifier and a JSON string listing the prior messages this alert updates
* `eventCode` / `code` - CAP event codes as a JSON string, and the CAP profile code
* `note` - Free-text service notices from the issuer, when present
* `hazardName` / `hazardSeverity` / `incidentLocationName` - DisasterAWARE title, severity, and location
* `language` / `audience` / `contact` / `web` / `resource` / `parameter` / `area` - Remaining CAP fields, frequently null or `"null"`

### Features

The `features` collection contains `EXPOSURE_AREA` polygons (one per severity zone, e.g. LIMITED and MODERATE) and a `SMART_ALERT` polygon. The `features` collection carries `metadata`, `incidentType`, and `sourceId` at collection level alongside `type` and `features`, and each feature's `geometry` object embeds a copy of the feature's `properties`. See [Feature collections](/hazards/requesting-active-hazards.md#feature-collection-structure).

### Exposure Areas

Marine hazards use up to two exposure levels representing the source-provided marine zones:

* **Level 0**: LIMITED - outer zone
* **Level 1**: MODERATE - core zone

Because marine zones are offshore, `exposureAssessment` population totals are frequently zero, as in this sample; the block is still present.

### Source

`source` is `null` on this record; the issuer is identified in `incident.properties.senderName`.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Special Marine - N of Tuktoyaktuk, Northwest Territories, Canada"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "Environment Canada has issued a Special Marine warning for September 11, 2026 20:39:46 UTC through September 12, 2026 12:39:46 UTC.\n\nModels do not show a significant concentration of population within the affected area.\n\nspecial marine warning in effect\nPeriods of freezing rain will continue today. The freezing rain will persist this evening and end Saturday afternoon. Please continue to monitor alerts and forecasts issued by Environment Canada. For more information monitor Canadian Coast Guard radio or Weatheradio stations.\n\nspecial marine warning ended\n\n"
    }
  ],
  "severity": "WARNING",
  "category": "EVENT",
  "incident": {
    "uuid": "f8b23f14-8171-4d23-a46d-da43c57dfb3a",
    "type": "MARINE",
    "sourceId": 1800,
    "sourceRecordId": "urn:oid:2.49.0.1.124.1934080096.2026",
    "properties": {
      "note": "Service Notice – July 2026: The Environment and Climate Change Canada (ECCC) CAP Service undergoes changes from time to time as the business of alerting evolves. For Spring 2026, changes are expected to include... 1) ECCC's deployment to introduce free-form polygons to represent the true threat area of a weather hazard, which was originally scheduled for June 2026, is delayed. We will communicate the new date when it is available. Monitor https://dd.weather.gc.ca/doc/genots/ for notifications on the new launch date. Information about free-form polygons representing the true threat area of a weather hazard remains under media embargo until launch, 2) marine alerts will now be issued for small ... [truncated for brevity]",
      "expires": "2026-09-12T12:39:46Z",
      "msgType": "Update",
      "code": "layer:SOREM:2.0",
      "hazardName": "Special Marine - N of Tuktoyaktuk, Northwest Territories, Canada",
      "references": "[{\"sender\":\"cap-pac@canada.ca\",\"identifier\":\"urn:oid:2.49.0.1.124.1934080096.2026\",\"sent\":1789087636000},{\"sender\":\"cap-pac@canada.ca\",\"identifier\":\"urn:oid:2.49.0.1.124.1331673164.2026\",\"sent\":1789116797000},{\"sender\":\"cap-pac@canada.ca\",\"identifier\":\"urn:oid:2.49.0.1.124.1680232312.2026\",\"sent\":1789144444000}]",
      "description": "Periods of freezing rain will continue today. The freezing rain will persist this evening and end Saturday afternoon. Please continue to monitor alerts and forecasts issued by Environment Canada. For more information monitor Canadian Coast Guard radio or Weatheradio stations.\n\n",
      "language": null,
      "source": "Env. Can. - Can. Met. Ctr. – Montréal",
      "type": "ACTUAL",
      "rawMessage": "S3://messagestorage.pdc.org/PROD/messages/canada_met/1ccb832d4e3a0afde3f2cd8db5a0cb46.xml",
      "sourceRecordId": "urn:oid:2.49.0.1.124.1122666884.2026",
      "effective": "2026-09-11T20:39:46Z",
      "senderName": "Environment Canada",
      "urgency": "Immediate, Past",
      "web": "general public",
      "scope": "Public",
      "contact": "",
      "parameter": "null",
      "hazardSeverity": "WARNING",
      "event": "Special Marine",
      "headline": "special marine warning in effect\nspecial marine warning ended",
      "responseTypes": null,
      "severity": "Moderate",
      "headlineDescription": "special marine warning in effect\nPeriods of freezing rain will continue today. The freezing rain will persist this evening and end Saturday afternoon. Please continue to monitor alerts and forecasts issued by Environment Canada. For more information monitor Canadian Coast Guard radio or Weatheradio stations.\n\nspecial marine warning ended",
      "area": "null",
      "identifier": null,
      "incidentLocationName": "N of Tuktoyaktuk, Northwest Territories, Canada",
      "audience": "general public",
      "resource": "null",
      "certainty": "Likely, Observed",
      "onset": "2026-09-11T20:38:00Z",
      "sent": 1789159186000,
      "eventCode": "[{\"valueName\":\"profile:CAP-CP:Event:0.4\",\"value\":\"spclMarine\"},{\"valueName\":\"SAME\",\"value\":\"SMW\"},{\"valueName\":\"profile:CAP-CP:Event:0.4\",\"value\":\"spclMarine\"},{\"valueName\":\"SAME\",\"value\":\"SMW\"}]",
      "sender": "cap-pac@canada.ca",
      "instruction": "",
      "processedAt": 1789159542027,
      "category": "Met",
      "status": null
    }
  },
  "uuid": "4a9408ab-9525-46ed-8f17-a45792bfebc2",
  "comment": "",
  "createdAt": 1789159551,
  "relatedHazards": [],
  "longitude": -135.49793,
  "latitude": 72.97618,
  "version": 5,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": {
    "features": [
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "severity": "LIMITED",
          "featureType": "EXPOSURE_AREA",
          "type": "EXPOSURE_AREA"
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "LIMITED"
          }
        },
        "incidentType": null,
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "severity": "MODERATE",
          "featureType": "EXPOSURE_AREA",
          "type": "EXPOSURE_AREA"
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "MODERATE"
          }
        },
        "incidentType": null,
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "featureType": "SMART_ALERT",
          "type": "SMART_ALERT"
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "SMART_ALERT",
            "featureType": "SMART_ALERT"
          }
        },
        "incidentType": null,
        "sourceId": null
      }
    ],
    "incidentType": null,
    "metadata": null,
    "type": "FeatureCollection",
    "sourceId": null
  },
  "exposureAreas": {
    "features": [
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 0
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "LIMITED"
          }
        },
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 1
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "MODERATE"
          }
        },
        "sourceId": null
      }
    ],
    "type": "FeatureCollection"
  },
  "exposureAssessment": {
    "population": {
      "total": 0.0,
      "total0_14": 0,
      "total15_64": 0,
      "households": 0.0,
      "vulnerable": 0.0,
      "total65_Plus": 0
    },
    "capital": {
      "total": 0.0,
      "school": 0,
      "hospital": 0
    },
    "totalByCountry": [
      {
        "population": {
          "total": 0.0,
          "total0_14": 0,
          "total15_64": 0,
          "households": 0.0,
          "vulnerable": 0.0,
          "total65_Plus": 0
        },
        "country": "CAN",
        "capital": {
          "total": 0.0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 0.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 0.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 0.0
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 0.0,
          "total0_14": 0,
          "total15_64": 0,
          "households": 0.0,
          "vulnerable": 0.0,
          "total65_Plus": 0
        },
        "country": "CAN",
        "capital": {
          "total": 0.0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 0.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 0.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 0.0
      }
    ],
    "exposureLevels": [
      {
        "level": "0",
        "data": {
          "population": {
            "total": 0.0,
            "total0_14": 0,
            "total15_64": 0,
            "households": 0.0,
            "vulnerable": 0.0,
            "total65_Plus": 0
          },
          "capital": {
            "total": 0.0,
            "school": 0,
            "hospital": 0
          },
          "totalByCountry": [
            {
              "population": {
                "total": 0.0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0.0,
                "vulnerable": 0.0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0.0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 0.0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0.0,
                "vulnerable": 0.0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0.0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 0.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 0.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 0.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 0.0
        },
        "exposureDescription": "LIMITED"
      },
      {
        "level": "1",
        "data": {
          "population": {
            "total": 0.0,
            "total0_14": 0,
            "total15_64": 0,
            "households": 0.0,
            "vulnerable": 0.0,
            "total65_Plus": 0
          },
          "capital": {
            "total": 0.0,
            "school": 0,
            "hospital": 0
          },
          "totalByCountry": [
            {
              "population": {
                "total": 0.0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0.0,
                "vulnerable": 0.0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0.0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 0.0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0.0,
                "vulnerable": 0.0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0.0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 0.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 0.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 0.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 0.0
        },
        "exposureDescription": "MODERATE"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1789159547087",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 0.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 0.0,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 0.0,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 0.0
  },
  "type": "MARINE",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1789087636,
  "updatedAt": 1789159547,
  "endedAt": 1789216786
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. In actual API responses, these properties contain complete GeoJSON coordinate arrays. Long text fields have been truncated. All other values are verbatim from the production API as of 2026-09-11.
{% endhint %}