> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v2.52.0 - Geofence Monitors API

> New Geofence Monitors endpoints added to the Notifications API

**Released 7th September 2026**

## Geofence monitors API

This release introduces the Geofence Monitors API under the Notifications service. You can now create, retrieve, and cancel geofence monitors programmatically via REST endpoints.

<Check>
  **Backward-compatible addition:** This release introduces no breaking changes. Existing integrations continue to work without modification.
</Check>

### New endpoints

<AccordionGroup>
  <Accordion title="Geofence monitor management" icon="sparkles">
    Four new endpoints are available for managing geofence monitors:

    | Method | Endpoint | Description |
    | - | - | - |
    | `GET` | `/v2/notifications/geofence-monitors` | List geofence monitors |
    | `POST` | `/v2/notifications/geofence-monitors` | Create a geofence monitor |
    | `GET` | `/v2/notifications/geofence-monitors/{geofence_monitor_id}` | Retrieve a geofence monitor |
    | `POST` | `/v2/notifications/geofence-monitors/{geofence_monitor_id}/cancel` | Cancel a geofence monitor |

    **Example: create a geofence monitor**

    ```bash theme={null}
    POST /v2/notifications/geofence-monitors
    Content-Type: application/json

    {
      "stops": [
        {
          "geofence_id": "<geofence-uuid>",
          "arrival_required": true
        }
      ]
    }
    ```

    **Example: cancel a geofence monitor**

    ```bash theme={null}
    POST /v2/notifications/geofence-monitors/{geofence_monitor_id}/cancel
    ```
  </Accordion>
</AccordionGroup>

### New schemas

The following schemas have been added to support the Geofence Monitors API:

| Schema | Description |
| - | - |
| `GeofenceMonitorCreate` | Request body for creating a geofence monitor |
| `GeofenceMonitorRead` | Response model for a geofence monitor |
| `GeofenceMonitorStopCreate` | Individual stop definition within a monitor |
| `GeofenceMonitorStopRead` | Individual stop as returned in responses |
| `GeofenceMonitorStatusEnum` | Possible statuses for a geofence monitor |
| `GeofenceMonitorSortField` | Sort fields available when listing monitors |

### Webhook events

Geofence monitor lifecycle events are delivered via the existing webhook system. Subscribe to any of the following event names:

* `geofence_monitor.created`
* `geofence_monitor.arrived`
* `geofence_monitor.departed`
* `geofence_monitor.completed`
* `geofence_monitor.cancelled`
* `geofence_monitor.expired`
* `geofence_monitor.*` (wildcard — all geofence monitor events)

***

## Need help?

<CardGroup cols={2}>
  <Card title="API reference" icon="book" href="/api-reference/notifications-api">
    View complete endpoint documentation for the Notifications API
  </Card>

  <Card title="Contact support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about this release? Our team is here to help
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.