API Reference V1

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 intgrations endpoints:

• AWS Integration
• AWS Logs Integration
• Azure Integration
• GCP Integration
• Slack Integration
• PagerDuty Integration
• Webhooks Integration

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:

• Build Dashboards and view Dashboard Lists
• Manage host tags
• Create Embeddable Graphs
• Take a graph snapshot
• Service Dependencies - see a list of your APM services and their dependencies
• Create Monitors
• Service Checks - post check statuses for use with monitors
• Create and manage Logs, Logs Indexes, and Logs Pipelines
• Get Host information for your organization
• Create and manage Service Level Objectives
• Generate Security Monitoring signals

Manage your account

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

• Manage Users
• Manage Roles
• Manage your Organization
• Veirfy API and app keys with the Authentication endpoint
• Grant specific logs access with the Logs Restriction Queries
• Manage existing keys with Key Management
• Get get hourly, daily, and monthly usage across multiple facets of Datadog with the Usage Metering endpoints
• See the list of IP prefixes belonging to Datadog withIP Ranges

Rate limiting

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

Headers are returned for rate limited API endpoints 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.