---
title: "Changes to Event statistics"
method: GET
path: "/api/v1/gfw/events/stats"
---

# Changes to Event statistics

`GET /api/v1/gfw/events/stats`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 22 revisions.

- **2026-09-01** `328d061c12ca` — 3 info
- **2026-08-28** `560e8847c7b3` — 13 breaking, 2 info
- **2026-08-08** `4c4530760ba1` — 12 info

## Changes

- **2026-09-01** `328d061c12ca` — 3 info
  - added the optional property `meta/data_age_days` to the response with the `200` status
  - added the optional property `meta/notes` to the response with the `200` status
  - added the optional property `meta/period` to the response with the `200` status
- **2026-08-28** `560e8847c7b3` — 13 breaking, 2 info
  - the response property `data/date_range` became optional for the status `200`
  - the response property `data/event_type` became optional for the status `200`
  - the response property `data/stats` became optional for the status `200`
  - response property `data/event_type` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/date_range` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `data/stats` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `data/date_range/end` from the response with the `200` status
  - removed the required property `data/date_range/start` from the response with the `200` status
  - removed the required property `data/stats/flags` from the response with the `200` status
  - removed the required property `data/stats/numEvents` from the response with the `200` status
  - removed the required property `data/stats/numFlags` from the response with the `200` status
  - removed the required property `data/stats/numVessels` from the response with the `200` status
  - removed the required property `data/stats/timeseries` from the response with the `200` status
  - added `#/components/schemas/DateRange, subschema #2` to the `data/date_range` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/GfwStats, subschema #2` to the `data/stats` response property `anyOf` list for the response status `200`
- **2026-08-08** `4c4530760ba1` — 12 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `429` status
  - added the optional property `code` to the response with the `503` status
  - added the optional property `hint` to the response with the `401` status
  - added the optional property `hint` to the response with the `429` status
  - added the optional property `hint` to the response with the `503` status
  - added the optional property `plan` to the response with the `401` status
  - added the optional property `plan` to the response with the `429` status
  - added the optional property `plan` to the response with the `503` status
  - added the optional property `reason` to the response with the `401` status
  - added the optional property `reason` to the response with the `429` status
  - added the optional property `reason` to the response with the `503` status

---

[Operation](https://skmtc.dev/sugra/apis/sugra-api/docs/api/v1/gfw/events/stats/get.md) · [API](https://skmtc.dev/sugra/apis/sugra-api.md) · [Page](https://skmtc.dev/sugra/apis/sugra-api/changes/api/v1/gfw/events/stats/get)
