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

# 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 →{% #get-all-service-definitions %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/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  |
| 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 |

## Create or update service definition →{% #create-or-update-service-definition %}

| Datadog site      | API endpoint                                                   |
| ----------------- | -------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/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  |
| 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 |

## Get a single service definition →{% #get-a-single-service-definition %}

| Datadog site      | API endpoint                                                                 |
| ----------------- | ---------------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/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}  |
| 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} |

## Delete a single service definition →{% #delete-a-single-service-definition %}

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/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}  |
| 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} |