---
title: "Report a successful band drain (or that the band was unpaired)"
method: POST
path: "/api/push/sync-report"
tags: ["Push"]
---

# Report a successful band drain (or that the band was unpaired)

`POST /api/push/sync-report`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/push/sync-report`
- Auth: HTTP bearer

Feeds the band sync nudges. Does not count as the app being in the foreground.

## Request body

- object
  - `installation_id` string, required
  - `tracker_key` string, nullable
  - `drained_at` string, date-time: required unless paired is false
  - `records_received` integer, nullable
  - `battery_percent` integer, nullable
  - `charging` boolean, nullable
  - `used_sectors` integer, nullable
  - `total_sectors` integer, nullable
  - `trigger` string, nullable
  - `paired` boolean

## Response `200`

{ episode_closed, unpaired }. episode_closed: this report ended a stale episode. unpaired: this report (paired false) marked the band unpaired. It is false when the unpair came from an installation that does not hold the band (the band's latest drain came from another installation that is still registered) and names no band, or a different one: it is then ignored, and the app should report it again later.

---

[API](https://skmtc.dev/hiyd/apis/hiyd-backend-api.md) - [All operations](https://skmtc.dev/hiyd/apis/hiyd-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiyd/apis/hiyd-backend-api/revisions/23598d347e1b?raw)
