API Reference
Security Monitoring is now available Security Monitoring is now available

API Reference

Use the Datadog HTTP API to programmatically access the Datadog platform. The Datadog API uses resource-oriented URLs, uses status codes to indicate the success or failure of requests and returns JSON from all requests.

To get started on the Datadog HTTP API, use the following flow to determine which endpoints you need and checkout our Datadog Postman collection.

Note: cURL code examples assume usage of BASH and GNU coreutils. On macOS you can install coreutils via the Homebrew package manager: brew install coreutils

Install the Datadog Agent

Before you can use the API to send or view data, you need to install the Datadog Agent. The Datadog Agent is software that runs on your hosts. It collects events and metrics from hosts and sends them to Datadog, where you can analyze your monitoring and performance data.

Send data to Datadog

Once you have the Datadog Agent set up, use the API to begin to send integrations data to Datadog. With some additional setup of the Agent, you can also use the API to send Synthetics, Logs and Traces to Datadog.

Integrations endpoints

Available integrations endpoints:

Platform endpoints

Use these endpoints to post and fetch data to and from other parts of the Datadog platform:

  • The metrics endpoints allow you to post metrics data so it can be graphed on Datadog’s dashboards and query metrics from any time period.
  • The events endpoints allow you to post and fetch events to and from the Datadog event stream.
  • Use the Synthetics endpoints to create, start, stop and see Synthetics tests results.
  • Use the Tracing Agent API to send traces to your Datadog Agent, which then forwards them to Datadog.

Visualize your data

Once you are sending data to Datadog, you can use the API to programatically build data visualizations:

Manage your account

You can also use the Datadog API to programatically manage your account:

Rate limiting

Some of the API endpoints are rate limited. Once you exceed a certain number of requests in a certain time period we return an error.

For rate limited API endpoints we return headers so you can know how close you are to your limit. If you exceed your limit, review these headers to determine when you are able to try again.

Rate limits can be increased from defaults by contacting the Datadog support team.

Regarding API rate limit policy:

  • Datadog does not rate limit on data point/metric submission (see metrics section for more info on how metric submission rate is handled). Limits encounter is dependent on the quantity of custom metrics based on your agreement.
  • The rate limit for metric retrieval is 100 per hour per organization.
  • The rate limit for event submission is 1000 per aggregate per day per organization. An aggregate is a group of similar events.
  • The rate limit for the Query a Timeseries API call is 600 per hour per organization. This can be extended on demand.
  • The rate limit for the Log Query API call is 300 per hour per organization. This can be extended on demand.
  • The rate limit for the Graph a Snapshot API call is 60 per hour per organization. This can be extended on demand.
  • The rate limit for the Log Configuration API is 6000 per minute per organization. This can be extended on demand.
Rate Limit HeadersDescription
X-RateLimit-Limitnumber of requests allowed in a time period.
X-RateLimit-Periodlength of time in seconds for resets (calendar aligned).
X-RateLimit-Remainingnumber of allowed requests left in current time period.
X-RateLimit-Resettime in seconds until next reset.