---
title: "Submit metrics"
method: POST
path: "/api/v1/series"
tags: ["Metrics"]
---

# Submit metrics

`POST /api/v1/series`

## Request

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

The metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards.
The maximum payload size is 3.2 megabytes (3200000 bytes). Compressed payloads must have a decompressed size of less than 62 megabytes (62914560 bytes).

If you’re submitting metrics directly to the Datadog API without using DogStatsD, expect:

- 64 bits for the timestamp
- 64 bits for the value
- 40 bytes for the metric names
- 50 bytes for the timeseries
- The full payload is approximately 100 bytes. However, with the DogStatsD API,
compression is applied, which reduces the payload size.

## Headers

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

## Request body `text/json`

- MetricsPayload: The metrics' payload.
  - `series` Series[], required: A list of timeseries to submit to Datadog.
    - `host` string: The name of the host that produced the metric.
    - `interval` integer, nullable: If the type of the metric is rate or count, define the corresponding interval in seconds.
    - `metric` string, required: The name of the timeseries.
    - `points` Point[], required: Points relating to a metric. All points must be tuples with timestamp and a scalar value (cannot be a string). Timestamps should be in POSIX time in seconds, and cannot be more than ten minutes in the future or more than one hour in the past.
      - number[]: Array of timeseries points.
    - `tags` string[]: A list of tags associated with the metric.
    - `type` string: The type of the metric. Valid types are "",`count`, `gauge`, and `rate`.

## 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)