---
title: "Get a test's latest results"
method: GET
path: "/api/v2/synthetics/tests/{public_id}/results"
tags: ["Synthetics"]
---

# Get a test's latest results

`GET /api/v2/synthetics/tests/{public_id}/results`

## Request

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

Get the latest result summaries for a given Synthetic test.

## Path parameters

- `public_id` string, required

## Query parameters

- `from_ts` integer
- `to_ts` integer
- `status` 'passed' | 'failed' | 'no_data': Status of a Synthetic test result.
- `runType` 'scheduled' | 'fast' | 'ci' | 'triggered': The type of run for a Synthetic test result.
- `probe_dc` string[]
- `device_id` string[]

## Response `200`

OK

- SyntheticsTestLatestResultsResponse: Response object for a Synthetic test's latest result summaries.
  - `data` SyntheticsTestResultSummaryData[]: Array of Synthetic test result summaries.
    - `attributes` SyntheticsTestResultSummaryAttributes: Attributes of a Synthetic test result summary.
      - `device` SyntheticsTestResultDevice: Device information for the test result (browser and mobile tests).
        - `browser` SyntheticsTestResultDeviceBrowser: Browser information for the device used to run the test.
          - `type` string: Browser type (for example, `chrome`, `firefox`).
          - `user_agent` string: User agent string reported by the browser.
          - `version` string: Browser version.
        - `id` string: Device identifier.
        - `name` string: Device name.
        - `platform` SyntheticsTestResultDevicePlatform: Platform information for the device used to run the test.
          - `name` string: Platform name (for example, `linux`, `macos`).
          - `version` string: Platform version.
        - `resolution` SyntheticsTestResultDeviceResolution: Screen resolution of the device used to run the test.
          - `height` integer: Viewport height in pixels.
          - `pixel_ratio` number, double: Device pixel ratio.
          - `width` integer: Viewport width in pixels.
        - `type` string: Device type.
      - `execution_info` SyntheticsTestResultExecutionInfo: Execution details for a Synthetic test result.
        - `duration` SyntheticsTestResultDuration: Total duration of a Synthetic test execution.
          - `has_duration` boolean: Whether a duration was recorded for this execution.
          - `value` integer: Duration value in milliseconds.
        - `error_message` string: Error message if the execution encountered an issue.
        - `is_fast_retry` boolean: Whether this result is from a fast retry.
        - `timings` object: Timing breakdown of the test execution in milliseconds.
        - `tunnel` boolean: Whether the test was executed through a tunnel.
        - `unhealthy` boolean: Whether the location was unhealthy during execution.
      - `finished_at` integer: Timestamp of when the test finished (in milliseconds).
      - `location` SyntheticsTestResultLocation: Location information for a Synthetic test result.
        - `id` string: Identifier of the location.
        - `name` string: Human-readable name of the location.
        - `version` string: Version of the worker that ran the test.
        - `worker_id` string: Identifier of the specific worker that ran the test.
      - `run_type` 'scheduled' | 'fast' | 'ci' | 'triggered': The type of run for a Synthetic test result.
      - `started_at` integer: Timestamp of when the test started (in milliseconds).
      - `status` 'passed' | 'failed' | 'no_data': Status of a Synthetic test result.
      - `steps_info` SyntheticsTestResultStepsInfo: Step execution summary for a Synthetic test result.
        - `completed` integer: Number of completed steps.
        - `errors` integer: Number of steps with errors.
        - `total` integer: Total number of steps.
      - `test_sub_type` 'dns' | 'grpc' | 'http' | 'icmp' | 'mcp' | 'multi' | 'ssl' | 'tcp' | 'udp' | 'websocket': Subtype of the Synthetic test that produced this result.
      - `test_type` 'api' | 'browser' | 'mobile' | 'network': Type of the Synthetic test that produced this result.
    - `id` string: The result ID.
    - `relationships` SyntheticsTestResultRelationships: Relationships for a Synthetic test result.
      - `test` SyntheticsTestResultRelationshipTest: Relationship to the Synthetic test.
        - `data` SyntheticsTestResultRelationshipTestData: Data for the test relationship.
          - `id` string: The public ID of the test.
          - `type` string: Type of the related resource.
    - `type` 'result_summary': Type of the Synthetic test result summary resource, `result_summary`.
  - `included` SyntheticsTestResultIncludedItem[]: Array of included related resources, such as the test definition.
    - `attributes` object: Attributes of the included resource.
    - `id` string: ID of the included resource.
    - `type` string: Type of the included resource.

## Other responses

- `400`: API error response.
- `404`: API error response.
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)