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

# Software Catalog

API to create, update, retrieve, and delete Software Catalog entities.

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

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

## Create or update entities →{% #create-or-update-entities %}

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

## Delete a single entity →{% #delete-a-single-entity %}

| Datadog site      | API endpoint                                                           |
| ----------------- | ---------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/catalog/entity/{entity_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/catalog/entity/{entity_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/catalog/entity/{entity_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/catalog/entity/{entity_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/catalog/entity/{entity_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/catalog/entity/{entity_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/catalog/entity/{entity_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/catalog/entity/{entity_id} |

## Preview catalog entities →{% #preview-catalog-entities %}

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

## Get a list of entity relations →{% #get-a-list-of-entity-relations %}

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

## Get a list of entity kinds →{% #get-a-list-of-entity-kinds %}

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

## Create or update kinds →{% #create-or-update-kinds %}

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

## Delete a single kind →{% #delete-a-single-kind %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/catalog/kind/{kind_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/catalog/kind/{kind_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/catalog/kind/{kind_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/catalog/kind/{kind_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/catalog/kind/{kind_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/catalog/kind/{kind_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/catalog/kind/{kind_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/catalog/kind/{kind_id} |