List observed product changes or one product's history

curl --request GET \
  --url http://127.0.0.1:5185/v1/changes

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "product_first_observed",
      "product": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "source_ids": {
          "utah_dabs_sku": "347210"
        },
        "name": "<string>",
        "brand": "<string>"
      },
      "store": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "source_ids": {
          "inventory_store_code": "0002"
        },
        "name": "<string>"
      },
      "change": {},
      "semantics": "first_observed_by_nektir",
      "times": {
        "source_updated_at": "2023-11-07T05:31:56Z",
        "retrieved_at": "2023-11-07T05:31:56Z",
        "published_at": "2023-11-07T05:31:56Z"
      },
      "upstream_age_known": true
    }
  ],
  "meta": {
    "page": {
      "has_more": true,
      "next_cursor": "<string>",
      "cursor_expires_at": "2023-11-07T05:31:56Z"
    },
    "history": {
      "tracking_started_at": "2023-11-07T05:31:56Z",
      "earliest_available_at": "2023-11-07T05:31:56Z",
      "latest_available_at": "2023-11-07T05:31:56Z",
      "retention_days": 400,
      "retained_event_count": 1,
      "source_update_time_known": true
    },
    "warnings": [
      {
        "code": "INVENTORY_COVERAGE_PARTIAL"
      }
    ],
    "family": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "member_scope": "members_visible_at_publication_revision"
    }
  },
  "links": {
    "self": "<string>",
    "next": "<string>"
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

List observed product changes or one product's history

Returns immutable events created atomically with a Nektir publication. Filter by product_id or sku for one product’s history. Inventory quantities are reported observations; a decrease is never labeled as a purchase or inferred sale. store_inventory_first_observed is a baseline observation, not a restock. Source update time remains null unless the upstream source supplies it. Every query is capped at the revision in X-Publication-Revision. The first page freezes an upper event bound within that revision, so concurrent or newer publications cannot move rows between pages or disagree with the response header.

curl --request GET \
  --url http://127.0.0.1:5185/v1/changes

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "product_first_observed",
      "product": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "source_ids": {
          "utah_dabs_sku": "347210"
        },
        "name": "<string>",
        "brand": "<string>"
      },
      "store": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "source_ids": {
          "inventory_store_code": "0002"
        },
        "name": "<string>"
      },
      "change": {},
      "semantics": "first_observed_by_nektir",
      "times": {
        "source_updated_at": "2023-11-07T05:31:56Z",
        "retrieved_at": "2023-11-07T05:31:56Z",
        "published_at": "2023-11-07T05:31:56Z"
      },
      "upstream_age_known": true
    }
  ],
  "meta": {
    "page": {
      "has_more": true,
      "next_cursor": "<string>",
      "cursor_expires_at": "2023-11-07T05:31:56Z"
    },
    "history": {
      "tracking_started_at": "2023-11-07T05:31:56Z",
      "earliest_available_at": "2023-11-07T05:31:56Z",
      "latest_available_at": "2023-11-07T05:31:56Z",
      "retention_days": 400,
      "retained_event_count": 1,
      "source_update_time_known": true
    },
    "warnings": [
      {
        "code": "INVENTORY_COVERAGE_PARTIAL"
      }
    ],
    "family": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "member_scope": "members_visible_at_publication_revision"
    }
  },
  "links": {
    "self": "<string>",
    "next": "<string>"
  }
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 499,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>"
    }
  ]
}

Headers

If-None-Match

string

Strong entity tag from an earlier response.

If-Modified-Since

string

HTTP-date fallback validator. ETag takes precedence.

Query Parameters

product_id

string<uuid>

Stable API-owned product UUID. Mutually exclusive with sku.

sku

string

Exact six-character Utah DABS SKU. Mutually exclusive with product_id.

Pattern: ^[0-9]{6}$

Examples:

"347210"

"004190"

store_id

string<uuid>

Restrict store-level inventory events to one stable API-owned store UUID.

types

enum<string>[]

Comma-separated observed event types with OR semantics.

Maximum array length: 8

Available options:

product_first_observed,

price_changed,

status_changed,

product_presentation_changed,

aggregate_inventory_changed,

store_inventory_first_observed,

store_inventory_changed,

catalog_presence_changed

since

string<date-time>

Inclusive lower bound on Nektir retrieval/observation time. A timezone is required.

until

string<date-time>

Inclusive upper bound on Nektir retrieval/observation time. A timezone is required.

limit

integer

default:25

Required range: 1 <= x <= 100

cursor

string

Signed opaque keyset cursor, valid for 15 minutes and only with the original resource endpoint, query, and sort. Reuse on another endpoint or with changed filters returns CURSOR_QUERY_MISMATCH. Follow links.next unchanged.

Maximum string length: 2048

Response

Newest-first page of retained observed changes.

data

object[]

required

Show child attributes

Exports

Changes

Availability

Products

Search

Brands

Product families

Stores

Metadata

List observed product changes or one product's history

Headers

Query Parameters

Response