---
updatedAt: 2026-08-20T19:33:37.000Z
agentTools:
  projectIndex: https://docs.delivr.ai/llms.txt
---

# Verify pixel installation

Verify that a pixel is installed. Fetches the page named by the required `?url=` parameter server-side and confirms the install script is present in its HTML, which verifies a fresh install before any visitor traffic exists, and counts the pixel's events over the last 24 hours; events are queryable within seconds of a page view. Either signal verifies. Tag-manager installs (for example Google Tag Manager) inject the script at runtime and are not detectable by the page scan; a page that cannot be fetched reports `fetch_failed`, which means "could not check", not "not installed". Name the target project with the `?project_id=` query parameter.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Platform Management",
    "version": "2.0.0",
    "description": "Manage your organization's **projects**, **pixels**, and **members**.\n\nAuthenticate with your organization API key (`X-Api-Key` + `X-Api-Secret`, the same key used for the data APIs). The key's organization is resolved from the key itself, so a project-scoped call names its target project in the request: a `project_id` field for writes, or a `?project_id=` query parameter for reads. A project outside the key's organization is rejected.\n\nYour organization itself is read, updated, and deleted under Account. Organizations are created by Delivr.\n\n**Base URL:** `https://api.delivr.ai`\n"
  },
  "servers": [
    {
      "url": "https://api.delivr.ai",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "Pixel",
      "description": "Tracking pixel management"
    }
  ],
  "paths": {
    "/api/v1/pixel/verify/{pixel_id}": {
      "get": {
        "operationId": "verifyPixel",
        "tags": [
          "Pixel"
        ],
        "summary": "Verify pixel installation",
        "description": "Verify that a pixel is installed. Fetches the page named by the required `?url=` parameter server-side and confirms the install script is present in its HTML, which verifies a fresh install before any visitor traffic exists, and counts the pixel's events over the last 24 hours; events are queryable within seconds of a page view. Either signal verifies. Tag-manager installs (for example Google Tag Manager) inject the script at runtime and are not detectable by the page scan; a page that cannot be fetched reports `fetch_failed`, which means \"could not check\", not \"not installed\". Name the target project with the `?project_id=` query parameter.",
        "parameters": [
          {
            "name": "pixel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/projectIdQuery"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Page URL to check for the pixel script. Must be an http(s) URL on a standard port that resolves to a public address; https:// is assumed when the scheme is omitted."
          }
        ],
        "responses": {
          "200": {
            "description": "Verification result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PixelVerifyResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/UnauthorizedGateway"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "ApiKeyAuth": [],
            "ApiSecretAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Organization API key (`dlvr_` prefixed), created in the dashboard at `https://app.delivr.ai/{org_id}/settings/api-keys`. Must be paired with the `X-Api-Secret` header."
      },
      "ApiSecretAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Secret",
        "description": "Secret half of the organization API key, paired with `X-Api-Key`. Both headers are required on every request."
      }
    },
    "parameters": {
      "projectIdQuery": {
        "name": "project_id",
        "in": "query",
        "required": true,
        "description": "Target project (org-key path). The project must belong to the key's organization.",
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "PixelVerifyResponse": {
        "type": "object",
        "required": [
          "response"
        ],
        "properties": {
          "response": {
            "type": "object",
            "required": [
              "pixel_id",
              "verified",
              "events_last_24h",
              "window_start",
              "window_end",
              "message"
            ],
            "properties": {
              "pixel_id": {
                "type": "string"
              },
              "verified": {
                "type": "boolean",
                "description": "True when at least one event was recorded in the checked window or the install script was found on the supplied page."
              },
              "events_last_24h": {
                "type": "integer",
                "format": "int64"
              },
              "window_start": {
                "type": "string",
                "format": "date-time"
              },
              "window_end": {
                "type": "string",
                "format": "date-time"
              },
              "message": {
                "type": "string"
              },
              "page": {
                "type": "object",
                "description": "Present only when `?url=` was supplied.",
                "required": [
                  "url",
                  "status"
                ],
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "found",
                      "not_found",
                      "fetch_failed"
                    ],
                    "description": "found: install script present in the page HTML. not_found: not present (tag-manager installs are not detectable). fetch_failed: the page could not be checked; do not treat as not installed."
                  },
                  "detail": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      },
      "Error": {
        "type": "object",
        "description": "The shape every failure this service returns. `type` selects the status: `invalid_request` is 400, `unauthorized` 401, `not_found` 404, `internal_error` 500. `help_url` is always present and is the empty string when no page applies.",
        "required": [
          "type",
          "code",
          "message",
          "help_url",
          "request_id"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "invalid_request",
              "unauthorized",
              "not_found",
              "internal_error"
            ],
            "description": "Failure class. Stable; switch on this rather than on the status line."
          },
          "code": {
            "type": "string",
            "description": "Specific reason within the class, for programmatic handling."
          },
          "message": {
            "type": "string",
            "description": "Human-readable explanation. Wording may change; do not match on it."
          },
          "help_url": {
            "type": "string",
            "description": "Documentation for this failure when one applies, empty otherwise."
          },
          "request_id": {
            "type": "string",
            "description": "Identifier for this request. Quote it when reporting a problem: it is how a failure gets traced."
          },
          "fields": {
            "type": "array",
            "description": "Per-field validation detail. Present only on an `invalid_request` raised by body validation, absent otherwise.",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string"
                },
                "constraint": {
                  "type": "string"
                },
                "allowed": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      },
      "GatewayError": {
        "type": "object",
        "description": "Refusal from the API gateway, which answers before the request reaches the service. A different shape from `Error`, and the only body a rejected key produces.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "What was wrong with the credentials.",
            "example": "API key is required"
          }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Invalid request: a malformed body, a missing required field, or a value the endpoint does not accept.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "NotFound": {
        "description": "The named record does not exist, or lies outside the caller's organization.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "InternalError": {
        "description": "Unexpected server error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "UnauthorizedGateway": {
        "description": "Missing, malformed, or rejected API key. Refused by the gateway, so the body is `{\"error\": \"...\"}` rather than the `Error` envelope every other failure on this operation uses.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/GatewayError"
            }
          }
        }
      }
    }
  }
}
```