---
title: "Get storefront pixel state"
method: GET
path: "/integrations/{id}/pixel"
tags: ["Integrations"]
---

# Get storefront pixel state

`GET /integrations/{id}/pixel`

Reads the live state of a Shopify store's storefront tracking pixel. Nothing about the pixel is stored locally, so this queries the store on every call. A confirmed missing or stale pixel prevents on-site events (product views, cart activity, browse abandonment) from arriving; a Shopify read error reports the state as unknown instead. Shopify only. Requires the account:read scope.

## Path parameters

- `id` string, required

## Response `200`

Pixel state

- IntegrationPixelState — Live storefront tracking pixel state for a Shopify integration, read from the store on every call.
  - `success` boolean
  - `integrationId` string
  - `provider` string
  - `shopDomain` string
  - `pixel` object
    - `installed` boolean — Whether a pixel for this app exists on the store.
    - `id` string, nullable — Shopify's pixel ID.
    - `endpoint` string, nullable — Callback URL the installed pixel posts events to.
    - `endpointCurrent` boolean — Whether the pixel posts to this account's canonical endpoint or the supported Shopify compatibility endpoint.
    - `configurationCurrent` boolean — Whether the endpoint and signed company, shop, and integration settings all match the current connection.
    - `healthy` boolean — Installed, current, and confirmed by Shopify. Check this before relying on any on-site event.
    - `error` string, nullable — Set when Shopify could not be reached or refused the query. Distinct from "not installed" - the state is unknown.
  - `dependentEvents` string[] — Event names that depend on this pixel. They are confirmed unable to arrive only when pixel.error is null and pixel.healthy is false.
  - `message` string

## Other responses

- `400` — Provider has no storefront pixel, or the integration is disconnected or missing credentials
- `401` — Unauthorized
- `404` — Integration not found

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/af1cf9620482/schema)