---
title: Spans
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Spans
---

# Spans

Search and aggregate your spans from your Datadog platform over HTTP.

## Get a list of spans →{% #get-a-list-of-spans %}

| Datadog site      | API endpoint                                          |
| ----------------- | ----------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/spans/events |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/spans/events |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/spans/events      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/spans/events      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/spans/events  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/spans/events     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/spans/events |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/spans/events |

## Search spans →{% #search-spans %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/spans/events/search |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/spans/events/search |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/spans/events/search      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/spans/events/search      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/spans/events/search  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/spans/events/search     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/spans/events/search |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/spans/events/search |

## Aggregate spans →{% #aggregate-spans %}

| Datadog site      | API endpoint                                                        |
| ----------------- | ------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/spans/analytics/aggregate |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/spans/analytics/aggregate |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/spans/analytics/aggregate      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/spans/analytics/aggregate      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/spans/analytics/aggregate  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/spans/analytics/aggregate     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/spans/analytics/aggregate |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/spans/analytics/aggregate |