---
title: "Submit distribution points"
method: POST
path: "/api/v1/distribution_points"
tags: ["Metrics"]
---

# Submit distribution points

`POST /api/v1/distribution_points`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v1/distribution_points`
- Auth: API key in header `DD-API-KEY`

The distribution points end-point allows you to post distribution data that can be graphed on Datadog’s dashboards.

## Headers

- `Content-Encoding` 'deflate': HTTP header used to compress the media-type.

## Request body `text/json`

- DistributionPointsPayload: The distribution points payload.
  - `series` DistributionPointsSeries[], required: A list of distribution points series to submit to Datadog.
    - `host` string: The name of the host that produced the distribution point metric.
    - `metric` string, required: The name of the distribution points metric.
    - `points` DistributionPoint[], required: Points relating to the distribution point metric. All points must be tuples with timestamp and a list of values (cannot be a string). Timestamps should be in POSIX time in seconds.
      - union[]: Array of distribution points.
        - union: List of distribution point.
          - number, double: Distribution point timestamp. It should be in seconds and current.
          - number[]: Distribution point data.
    - `tags` string[]: A list of tags associated with the distribution point metric.
    - `type` 'distribution': The type of the distribution point.

## Response `202`

Payload accepted

## Other responses

- `400`: Bad Request
- `403`: Authentication error
- `408`: Request timeout
- `413`: Payload too large
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v1-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/revisions/ca5871004d26?raw)