DAdatadog
Deployment Gates

List deployment gate evaluations

Returns deployment gate evaluations started in a maximum 30-day window (the default is the previous 24 hours). Results are ordered by start time, newest first. In-progress state is near-real-time and mutable. Finished state is eventually consistent.

get/api/v2/deployment_gates/evaluations

Request

Query parameters

filter[from]string date-time

Inclusive evaluation start time. Defaults to 24 hours before the request. Together with filter[to], the window may span no more than 30 days.

filter[to]string date-time

Exclusive evaluation start time. Defaults to the request time. Must be after filter[from]; the window may span no more than 30 days.

filter[service]string[]

Service values. Repeated or comma-separated values are combined with OR.

filter[env]string[]

Environment values. Repeated or comma-separated values are combined with OR.

filter[identifier]string[]

Gate identifier values. Repeated or comma-separated values are combined with OR.

filter[status]DeploymentGatesEvaluationResultResponseAttributesGateStatus[]

Gate outcomes. Repeated or comma-separated values are combined with OR.

[
  "pass"
]
filter[dry_run]boolean

Gate-level dry-run state.

filter[evaluation_id]string uuid

Gate evaluation UUID. No match returns an empty list.

filter[gate_id]string uuid

Configured gate UUID. Just-in-time evaluations have no gate ID.

filter[version]string[]

Deployment version values. Repeated or comma-separated values are combined with OR.

page[size]integer

Maximum evaluations returned.

page[cursor]string

Opaque cursor returned in meta.page.next_cursor by the previous page. Invalid cursors return 400.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "dry_run": true,
        "duration_seconds": 900,
        "env": "prod",
        "evaluation_id": "7853af70-e6bf-49d8-a6cc-1b9b50ef0537",
        "finished_at": "2026-09-14T08:15:00Z",
        "gate_id": "e7cd2af1-b67b-11ee-8d0d-2a7caf4aa214",
        "identifier": "default",
        "service": "checkout",
        "started_at": "2026-09-14T08:00:00Z",
        "status": "pass",
        "version": "2026.09.14.1"
      },
      "id": "7853af70-e6bf-49d8-a6cc-1b9b50ef0537",
      "type": "deployment_gate_evaluation"
    }
  ],
  "meta": {
    "page": {
      "size": 1
    }
  }
}

Changes

Changes to this operation have not been checked yet.