# Statistics on events (/docs/v3/events/stats)



Get events statistics worldwide or for a specific region. The available events to get stats are:

* Fishing events

* Encounter events

* Loitering events

* AIS Off events (aka GAPs)

* Port visits

### Events Stats POST examples [#events-stats-post-examples]

These examples are available:

1. [**Example 1 (POST)**](/docs/examples/events/stats-example1) - Get Encounters Stats
2. [**Example 2 (POST)**](/docs/examples/events/stats-example2) - Get Fishing Events Stats in a Custom Region
3. [**Example 3 (POST)**](/docs/examples/events/stats-example3) - Get Port Visits Stats in a Region ID (Senegal)

### Events Stats POST - Specifications [#events-stats-post---specifications]

<OpenAPIPage document="apiv3" operations="[{ path: '/api/v3/events/stats', method: 'post' }]" hasHead="false" />

### Events Stats Response fields [#events-stats-response-fields]

| Name       | Type                                                                                                   | Required | Restrictions | Description                     |
| ---------- | ------------------------------------------------------------------------------------------------------ | -------- | ------------ | ------------------------------- |
| flags      | \[string]                                                                                              | true     | none         | Distinct flags                  |
| numEvents  | number                                                                                                 | true     | none         | Number of events                |
| numFlags   | number                                                                                                 | true     | none         | Number of distinct vessel flags |
| numVessels | number                                                                                                 | true     | none         | Number of distinct vessels      |
| timeseries | \[[See Timeseries definition below](docs/v3/events/stats#properties-events-stats-response-timeseries)] | true     | none         | Timeseries                      |

##### Properties Events Stats Response Timeseries [#properties-events-stats-response-timeseries]

| Name  | Type              | Required | Restrictions | Description      |
| ----- | ----------------- | -------- | ------------ | ---------------- |
| date  | string(date-time) | true     | none         | Date             |
| value | number            | true     | none         | Number of events |