---
title: Service Definition
description: API to create, update, retrieve and delete service definitions.
breadcrumbs: Docs > API > Service Definition
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt).

# Service Definition

API to create, update, retrieve and delete service definitions.
Note: Service Catalog [v3.0 schema](https://docs.datadoghq.com/service_catalog/service_definitions/v3-0.md) has new API endpoints documented under [Software Catalog](https://docs.datadoghq.com/api/latest/software-catalog.md). Use the following Service Definition endpoints for v2.2 and earlier.

## [Get all service definitions](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/service-definition/get-all-service-definitions.md)

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

## [Create or update service definition](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/service-definition/create-or-update-service-definition.md)

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

## [Get a single service definition](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/service-definition/get-a-single-service-definition.md)

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

## [Delete a single service definition](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/service-definition/delete-a-single-service-definition.md)

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