---
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/`

## Request

- Base URL: `https://api.cloverhealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloverhealth.com/api/v1/field-providers/location/pings/`
- Auth: HTTP bearer

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.dev/cloverhealth/apis/clover-api.md) - [All operations](https://skmtc.dev/cloverhealth/apis/clover-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloverhealth/apis/clover-api/revisions/824d541751f2?raw)