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

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Reference Tables

View and manage Reference Tables in your organization.

## [Create reference table upload →](https://docs.datadoghq.com/api/latest/reference-tables/create-reference-table-upload.md){% #create-reference-table-upload %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/reference-tables/uploads |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/reference-tables/uploads |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/reference-tables/uploads      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/reference-tables/uploads      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/reference-tables/uploads  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/reference-tables/uploads |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/reference-tables/uploads     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/reference-tables/uploads |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/reference-tables/uploads |

## [Create reference table →](https://docs.datadoghq.com/api/latest/reference-tables/create-reference-table.md){% #create-reference-table %}

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

## [List tables →](https://docs.datadoghq.com/api/latest/reference-tables/list-tables.md){% #list-tables %}

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

## [Get table →](https://docs.datadoghq.com/api/latest/reference-tables/get-table.md){% #get-table %}

| Datadog site      | API endpoint                                                          |
| ----------------- | --------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reference-tables/tables/{id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id} |

## [Get rows by id →](https://docs.datadoghq.com/api/latest/reference-tables/get-rows-by-id.md){% #get-rows-by-id %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}/rows      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reference-tables/tables/{id}/rows     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |

## [Update reference table →](https://docs.datadoghq.com/api/latest/reference-tables/update-reference-table.md){% #update-reference-table %}

| Datadog site      | API endpoint                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id} |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/reference-tables/tables/{id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id} |

## [Delete table →](https://docs.datadoghq.com/api/latest/reference-tables/delete-table.md){% #delete-table %}

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/reference-tables/tables/{id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id} |

## [Upsert rows →](https://docs.datadoghq.com/api/latest/reference-tables/upsert-rows.md){% #upsert-rows %}

| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}/rows      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/reference-tables/tables/{id}/rows     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |

## [Delete rows →](https://docs.datadoghq.com/api/latest/reference-tables/delete-rows.md){% #delete-rows %}

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}/rows      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/reference-tables/tables/{id}/rows     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id}/rows |

## [Batch rows query →](https://docs.datadoghq.com/api/latest/reference-tables/batch-rows-query.md){% #batch-rows-query %}

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/reference-tables/queries/batch-rows |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/reference-tables/queries/batch-rows |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/reference-tables/queries/batch-rows      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/reference-tables/queries/batch-rows      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/reference-tables/queries/batch-rows  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/reference-tables/queries/batch-rows |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/reference-tables/queries/batch-rows     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/reference-tables/queries/batch-rows |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/reference-tables/queries/batch-rows |

## [List rows →](https://docs.datadoghq.com/api/latest/reference-tables/list-rows.md){% #list-rows %}

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows/list |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reference-tables/tables/{id}/rows/list |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reference-tables/tables/{id}/rows/list      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows/list      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reference-tables/tables/{id}/rows/list  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reference-tables/tables/{id}/rows/list |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reference-tables/tables/{id}/rows/list     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reference-tables/tables/{id}/rows/list |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reference-tables/tables/{id}/rows/list |