unleash.unleash/website/docs/api/client/metrics-api.md

---
id: metrics
title: /api/client/metrics
---

> In order to access the client API endpoints you need to identify yourself. Unless you're using the `none` authentication method, you'll need to [create a CLIENT token](/user_guide/api-token) and add an Authorization header using the token.

### Send metrics {#send-metrics}

`POST: http://unleash.host.com/api/client/metrics`

Register a metrics payload with a timed bucket.

```json
{
  "appName": "appName",
  "instanceId": "instanceId",
  "bucket": {
    "start": "2016-11-03T07:16:43.572Z",
    "stop": "2016-11-03T07:16:53.572Z",
    "toggles": {
      "toggle-name-1": {
        "yes": 123,
        "no": 321
      },
      "toggle-name-2": {
        "yes": 111,
        "no": 0
      }
    }
  }
}
```