---
title: "Report a batch of location pings"
method: POST
path: "/api/v1/field-providers/location/pings/"
tags: ["Field Providers", "Field API — Location"]
---

# Report a batch of location pings

`POST /api/v1/field-providers/location/pings/`

Bulk-inserts pings, ignoring any whose ``client_event_id`` already exists
(safe idempotent replay of a queued batch). Then publishes the batch to the
live-map SSE channel.

## Request body

- LocationPingBatchRequest
  - `pings` LocationPingItem[], required
    - `latitude` number, required
    - `longitude` number, required
    - `accuracy_meters` number, nullable
    - `recorded_at` string, date-time, required
    - `client_event_id` string, required

## Response `200`

OK

- LocationPingBatchResponse
  - `received` integer, required
  - `stored` integer, required

---

[API](https://skmtc.net/cloverhealth/apis/clover-api.md) · [All operations](https://skmtc.net/cloverhealth/apis/clover-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloverhealth/clover-api/revisions/28797307aae6/schema)