v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Service Definition

Get all service definitions

Get a list of all service definitions from the Datadog Service Catalog.

get/api/v2/services/definitions

Query parameters

page[size]integer
Example:10

Size for a given page. The maximum allowed value is 100.

page[number]integer

Specific page number to return.

schema_version'v1' | 'v2' | 'v2.1' | 'v2.2'

Schema versions

The schema version desired in the response.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "schema": {
          "contact": {
            "email": "contact@datadoghq.com",
            "slack": "https://yourcompany.slack.com/archives/channel123"
          },
          "extensions": {
            "myorg/extension": "extensionValue"
          },
          "external-resources": [
            {
              "name": "Runbook",
              "type": "runbook",
              "url": "https://my-runbook"
            }
          ],
          "info": {
            "dd-service": "myservice",
            "description": "A shopping cart service",
            "display-name": "My Service",
            "service-tier": "Tier 1"
          },
          "integrations": {
            "pagerduty": "https://my-org.pagerduty.com/service-directory/PMyService"
          },
          "org": {
            "application": "E-Commerce",
            "team": "my-team"
          },
          "schema-version": "v1",
          "tags": [
            "my:tag",
            "service:tag"
          ]
        }
      }
    }
  ]
}