Synthetics

Get an API test result

Get a specific full result from a given Synthetic API test.

get/api/v1/synthetics/tests/{public_id}/results/{result_id}

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/synthetics/tests/{public_id}/results/{result_id}
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: synthetics_read

Path parameters

public_idstring required

The public ID of the API test to which the target result belongs.

result_idstring required

The ID of the result to get.

Response

OK

check_timenumber double

When the API test was conducted.

check_versioninteger

Version of the API test used.

probe_dcstring

Locations for which to query the API test results.

result_idstring

ID of the API test result.

status0 | 1 | 2

The status of your Synthetic monitor.

  • O for not triggered
  • 1 for triggered
  • 2 for no data

Example response

{
  "check": {
    "config": {
      "assertions": [],
      "configVariables": [
        {
          "name": "VARIABLE_NAME",
          "type": "text"
        }
      ],
      "request": {
        "basicAuth": {
          "password": "PaSSw0RD!",
          "type": "web",
          "username": "my_username"
        },
        "bodyType": "text/plain",
        "callType": "unary",
        "mcpProtocolVersion": "2025-06-18",
        "proxy": {
          "url": "https://example.com"
        },
        "service": "Greeter",
        "toolName": "search",
        "url": "https://example.com"
      },
      "variables": [
        {
          "name": "VARIABLE_NAME",
          "type": "text"
        }
      ]
    }
  },
  "result": {
    "failure": {
      "message": "Error during DNS resolution (ENOTFOUND)."
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.