API Reference

Use the Datadog HTTP API to programmatically access the Datadog platform.

To get started on Datadog HTTP API, use our Datadog Postman collection

The Datadog API uses resource-oriented URLs, uses status codes to indicate the success or failure of requests and returns JSON from all requests. Let’s dive in and see how it works.

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

Authentication

All requests to Datadog’s API must be authenticated. Requests that write data require reporting access and require an API key. Requests that read data require full access and also require an application key.

curl "https://api.datadoghq.com/api/v1/validate" \
    -H "DD-API-KEY: <DATADOG_API_KEY>" \
    -H "DD-APPLICATION-KEY: <DATADOG_APPLICATION_KEY>"

Note: All Datadog API clients are configured by default to consume Datadog US site APIs. If you are on the Datadog EU site, set the environment variable DATADOG_HOST to https://api.datadoghq.eu or override this value directly when creating your client.

Manage your account’s API and application keys.

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_batch 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_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.