Machine-readable digest field reference

PricingBrief publishes one JSON document per public issue at /digest/<YYYY-WNN>.json. The response is additive and versioned: existing fields stay stable for schemaVersion 2, and new fields may appear without removing older ones.

Errors

Unknown weeks return HTTP 404 with a JSON body, so integrations never have to parse the shared HTML 404 page.

{"error":"not_found"}

Weeks without a published public issue return the same not_found response as unknown weeks. Public clients only see published issues.

Top-level fields

• schemaVersion: major JSON contract version. Breaking field changes require a version bump. trustReceipt has its own, independently-versioned schemaVersion, documented below.
• docsUrl: canonical URL for this field reference.
• issueId: immutable UUID for the public issue. It matches the source digest artifact id.
• weekStart: ISO timestamp for the beginning of the issue window.
• weekEnd: ISO timestamp for the end of the issue window.
• isoWeek: issue URL label shaped like YYYY-WNN.
• status: changed when at least one vendor has a published pricing, packaging, feature, or limit change; quiet when the issue has no meaningful pricing-page changes.
• summary: quiet-week summary object, or null for changed issues.
• watchedVendorCount: number of vendors represented by the issue's scrape-health snapshot.
• changedVendorCount: number of vendors with published priceChanges entries.
• trustReceipt: public evidence receipt for this issue, including source citation coverage and correction policy.
• vendors: array of vendors with published pricing-page changes. Quiet issues use an empty array.

Trust receipt fields

trustReceipt is present on every published issue. It summarizes the evidence fields that public readers can verify in the response. An indented field below lives nested inside the field directly above it, matching the "Full JSON example" section.

• schemaVersion: receipt contract version. Versioned independently of the top-level schemaVersion; the two numbers do not move together.
• sourceCitationCoverage: counts of published vendors and claims, plus how many claims carry source URLs and retained snapshot proof.
  • status: coverage computation status. Currently always complete.
  • publishedVendorCount: vendors present in this issue JSON.
  • publishedClaimCount: published claim objects present in this issue JSON.
  • sourceUrlClaimCount: published claims with a vendor source URL.
  • retainedSnapshotClaimCount: published claims with retained snapshot proof.
• correctionPolicy: the public corrections contact and the information needed to report a wrong claim.
  • contact: public corrections email address.
  • summary: human-readable instructions for what to include when reporting a wrong claim.

Summary fields

summary is present on every response. It is null when status is changed. When status is quiet, it is an object with these string fields.

• headline: short headline for the quiet issue.
• body: human-readable explanation that no meaningful pricing-page changes were detected.
• watchingLine: compact count or sample of vendors still being watched.

Vendor fields

• slug: stable lowercase vendor identifier used by PricingBrief internally and in generated artifacts.
• name: display name for the vendor.
• confidenceEvidence: the scrape-health inputs captured when this issue was built, or null when no scrape-health snapshot was available. Newer issues include state, daysCovered, windowDays, consecutiveFailures, lastFailureCode, and lastFailureAt so the derived confidence label remains auditable after the live vendor-health record changes.
• priceChanges: array of published change objects for this vendor. Despite the legacy field name, entries can describe packaging, feature, or limit changes with no dollar amount. Vendors with no published changes are omitted.

Change object fields

• tier: pricing tier or plan label, or null when the change is not tied to one named tier.
• oldPriceUSD: previous numeric price in USD, or null when no previous USD amount applies.
• newPriceUSD: current numeric price in USD, or null when no current USD amount applies.
• oldPriceDisplay: previous human-readable price text, or null when none applies.
• newPriceDisplay: current human-readable price text, or null when none applies.
• oldFeatureDisplay: previous human-readable feature, package, or limit text, or null when none applies.
• newFeatureDisplay: current human-readable feature, package, or limit text, or null when none applies.
• oldBillingPeriod: previous billing period such as monthly or annually, or null when unavailable or not relevant.
• newBillingPeriod: current billing period such as monthly or annually, or null when unavailable or not relevant.
• citationUrl: public vendor pricing page that supports the claim.
• changeDirection: price movement direction, one of up, down, added, removed, or unknown. added and removed apply only when an entire tier is added or removed. Text-only feature, packaging, or limit changes within an existing tier use unknown. Display text can still start with added: or removed: for line-level feature, packaging, or limit changes; do not infer changeDirection from those prefixes.
• confidence: scrape coverage confidence for that vendor. high means full clean coverage for the issue window; medium and low mean partial coverage; broken means the vendor was known-stuck during the window; unknown means no scrape-health row was available.
• snapshotIds: legacy ordered array kept for compatibility. Prefer the labeled snapshot fields below for new integrations.
• previousSnapshotId: hash of the comparison snapshot, or null for first-seen added tiers with no prior snapshot.
• currentSnapshotId: hash of the snapshot that supports the current claim.
• previousSnapshotUrl: public retained-evidence URL for previousSnapshotId, or null when there is no previous snapshot.
• currentSnapshotUrl: public retained-evidence URL for currentSnapshotId.
• previousCapturedAt: ISO timestamp for previousSnapshotId, or null when there is no previous snapshot.
• currentCapturedAt: ISO timestamp for currentSnapshotId.

Units and nullable fields

oldPriceUSD and newPriceUSD are USD amounts, not cents. A price field is nullable when the source change has no USD amount on that side, such as an added tier with no previous price, a removed tier with no current price, or a packaging, feature, limit, or other text-only pricing-page change. oldPriceDisplay, newPriceDisplay, oldFeatureDisplay, newFeatureDisplay, oldBillingPeriod, and newBillingPeriod are also nullable when the source does not provide a matching display value or billing period for that side of the change. previousSnapshotId and previousCapturedAt are nullable when there is no comparison snapshot.

Timestamp and citation proof fields

weekStart, weekEnd, previousCapturedAt, and currentCapturedAt are ISO timestamps. The snapshot fields are the proof chain behind each pricing-page claim: previousSnapshotId identifies the comparison capture, currentSnapshotId identifies the capture supporting the current claim, previousSnapshotUrl and currentSnapshotUrl link to public retained-evidence pages, and snapshotIds keeps both ids in comparison order for older consumers.

Full JSON example

{
  "schemaVersion": 2,
  "docsUrl": "https://pricingbrief.com/digest/schema",
  "issueId": "19829cde-b921-4536-8314-062f7e87d45e",
  "weekStart": "2026-06-29T05:00:19.731Z",
  "weekEnd": "2026-07-06T05:00:19.731Z",
  "isoWeek": "2026-W28",
  "status": "changed",
  "summary": null,
  "watchedVendorCount": 77,
  "changedVendorCount": 3,
  "vendors": [
    {
      "slug": "onepassword",
      "name": "1Password",
      "priceChanges": [
        {
          "tier": "Teams Starter Pack",
          "oldPriceUSD": 19.95,
          "newPriceUSD": 24.95,
          "oldPriceDisplay": "$19.95",
          "newPriceDisplay": "$24.95",
          "oldFeatureDisplay": null,
          "newFeatureDisplay": null,
          "oldBillingPeriod": "per month. Paid annually.",
          "newBillingPeriod": "per month. Paid annually.",
          "citationUrl": "https://1password.com/pricing/password-manager",
          "changeDirection": "up",
          "confidence": "high",
          "snapshotIds": [
            "0010abbbe408df973207a894d419122e4f00beed6322be135cffc38fae7fbbca",
            "469811d7959bbc12a9a03476440955dd1e615a7369060fb6143a7aa9949ed243"
          ],
          "previousSnapshotId": "0010abbbe408df973207a894d419122e4f00beed6322be135cffc38fae7fbbca",
          "currentSnapshotId": "469811d7959bbc12a9a03476440955dd1e615a7369060fb6143a7aa9949ed243",
          "previousCapturedAt": "2026-06-30T04:12:38.887Z",
          "currentCapturedAt": "2026-07-01T04:12:08.466Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/0010abbbe408df973207a894d419122e4f00beed6322be135cffc38fae7fbbca",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/469811d7959bbc12a9a03476440955dd1e615a7369060fb6143a7aa9949ed243"
        },
        {
          "tier": "Business",
          "oldPriceUSD": 7.99,
          "newPriceUSD": 8.99,
          "oldPriceDisplay": "$7.99",
          "newPriceDisplay": "$8.99",
          "oldFeatureDisplay": null,
          "newFeatureDisplay": null,
          "oldBillingPeriod": "Per user, per month. Paid annually.",
          "newBillingPeriod": "Per user, per month. Paid annually.",
          "citationUrl": "https://1password.com/pricing/password-manager",
          "changeDirection": "up",
          "confidence": "high",
          "snapshotIds": [
            "0010abbbe408df973207a894d419122e4f00beed6322be135cffc38fae7fbbca",
            "469811d7959bbc12a9a03476440955dd1e615a7369060fb6143a7aa9949ed243"
          ],
          "previousSnapshotId": "0010abbbe408df973207a894d419122e4f00beed6322be135cffc38fae7fbbca",
          "currentSnapshotId": "469811d7959bbc12a9a03476440955dd1e615a7369060fb6143a7aa9949ed243",
          "previousCapturedAt": "2026-06-30T04:12:38.887Z",
          "currentCapturedAt": "2026-07-01T04:12:08.466Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/0010abbbe408df973207a894d419122e4f00beed6322be135cffc38fae7fbbca",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/469811d7959bbc12a9a03476440955dd1e615a7369060fb6143a7aa9949ed243"
        }
      ]
    },
    {
      "slug": "honeycomb",
      "name": "Honeycomb",
      "priceChanges": [
        {
          "tier": "Free",
          "oldPriceUSD": null,
          "newPriceUSD": null,
          "oldPriceDisplay": null,
          "newPriceDisplay": null,
          "oldFeatureDisplay": "removed: Honeycomb MCP",
          "newFeatureDisplay": "added: Metrics Data Points: Up to 100M per month",
          "oldBillingPeriod": null,
          "newBillingPeriod": null,
          "citationUrl": "https://www.honeycomb.io/pricing",
          "changeDirection": "unknown",
          "confidence": "high",
          "snapshotIds": [
            "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
            "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
          ],
          "previousSnapshotId": "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotId": "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55",
          "previousCapturedAt": "2026-07-01T04:14:29.058Z",
          "currentCapturedAt": "2026-07-05T04:27:26.447Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
        },
        {
          "tier": "Pro",
          "oldPriceUSD": 130,
          "newPriceUSD": 150,
          "oldPriceDisplay": "$130/mo",
          "newPriceDisplay": "$150 per month",
          "oldFeatureDisplay": null,
          "newFeatureDisplay": null,
          "oldBillingPeriod": "per month",
          "newBillingPeriod": "per month",
          "citationUrl": "https://www.honeycomb.io/pricing",
          "changeDirection": "up",
          "confidence": "high",
          "snapshotIds": [
            "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
            "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
          ],
          "previousSnapshotId": "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotId": "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55",
          "previousCapturedAt": "2026-07-01T04:14:29.058Z",
          "currentCapturedAt": "2026-07-05T04:27:26.447Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
        },
        {
          "tier": "Pro",
          "oldPriceUSD": null,
          "newPriceUSD": null,
          "oldPriceDisplay": null,
          "newPriceDisplay": null,
          "oldFeatureDisplay": "removed: Event Volume: Up to 1.5B per month",
          "newFeatureDisplay": "added: Event Volume: Up to 750M per month · Metrics Data Points: Up to 3.75B per month",
          "oldBillingPeriod": null,
          "newBillingPeriod": null,
          "citationUrl": "https://www.honeycomb.io/pricing",
          "changeDirection": "unknown",
          "confidence": "high",
          "snapshotIds": [
            "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
            "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
          ],
          "previousSnapshotId": "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotId": "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55",
          "previousCapturedAt": "2026-07-01T04:14:29.058Z",
          "currentCapturedAt": "2026-07-05T04:27:26.447Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
        },
        {
          "tier": "Enterprise",
          "oldPriceUSD": null,
          "newPriceUSD": null,
          "oldPriceDisplay": null,
          "newPriceDisplay": null,
          "oldFeatureDisplay": "removed: Support for Honeycomb Private Cloud · Query Data API",
          "newFeatureDisplay": "added: Enterprise-Grade Support + Onboarding · Metrics Data Points: Variable",
          "oldBillingPeriod": null,
          "newBillingPeriod": null,
          "citationUrl": "https://www.honeycomb.io/pricing",
          "changeDirection": "unknown",
          "confidence": "high",
          "snapshotIds": [
            "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
            "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
          ],
          "previousSnapshotId": "e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotId": "3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55",
          "previousCapturedAt": "2026-07-01T04:14:29.058Z",
          "currentCapturedAt": "2026-07-05T04:27:26.447Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/e3bc2438770a9773a45817e565746493043e5cbd53c3a2f2070c9ecd6f8dddeb",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/3fd7f6527d6dbcf4a0837debf8e57fe033b199efece8b4f5855bf3a619198b55"
        }
      ]
    },
    {
      "slug": "pipedrive",
      "name": "Pipedrive",
      "priceChanges": [
        {
          "tier": "Lite",
          "oldPriceUSD": null,
          "newPriceUSD": null,
          "oldPriceDisplay": null,
          "newPriceDisplay": null,
          "oldFeatureDisplay": "removed: Personalized onboarding",
          "newFeatureDisplay": null,
          "oldBillingPeriod": null,
          "newBillingPeriod": null,
          "citationUrl": "https://www.pipedrive.com/en/pricing",
          "changeDirection": "unknown",
          "confidence": "high",
          "snapshotIds": [
            "da389d6c06a51b14f24eb4433de96424bbab0c6d1f25d0a96ae541ae1b1a7468",
            "24dee6867ea3c9471bb2a041b140acaff1bbb918c5620b8b2a878b8fd4ccdada"
          ],
          "previousSnapshotId": "da389d6c06a51b14f24eb4433de96424bbab0c6d1f25d0a96ae541ae1b1a7468",
          "currentSnapshotId": "24dee6867ea3c9471bb2a041b140acaff1bbb918c5620b8b2a878b8fd4ccdada",
          "previousCapturedAt": "2026-06-30T04:13:00.405Z",
          "currentCapturedAt": "2026-07-01T04:12:31.435Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/da389d6c06a51b14f24eb4433de96424bbab0c6d1f25d0a96ae541ae1b1a7468",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/24dee6867ea3c9471bb2a041b140acaff1bbb918c5620b8b2a878b8fd4ccdada"
        },
        {
          "tier": "Growth",
          "oldPriceUSD": null,
          "newPriceUSD": null,
          "oldPriceDisplay": null,
          "newPriceDisplay": null,
          "oldFeatureDisplay": "removed: Live chat support",
          "newFeatureDisplay": null,
          "oldBillingPeriod": null,
          "newBillingPeriod": null,
          "citationUrl": "https://www.pipedrive.com/en/pricing",
          "changeDirection": "unknown",
          "confidence": "high",
          "snapshotIds": [
            "da389d6c06a51b14f24eb4433de96424bbab0c6d1f25d0a96ae541ae1b1a7468",
            "24dee6867ea3c9471bb2a041b140acaff1bbb918c5620b8b2a878b8fd4ccdada"
          ],
          "previousSnapshotId": "da389d6c06a51b14f24eb4433de96424bbab0c6d1f25d0a96ae541ae1b1a7468",
          "currentSnapshotId": "24dee6867ea3c9471bb2a041b140acaff1bbb918c5620b8b2a878b8fd4ccdada",
          "previousCapturedAt": "2026-06-30T04:13:00.405Z",
          "currentCapturedAt": "2026-07-01T04:12:31.435Z",
          "previousSnapshotUrl": "https://pricingbrief.com/evidence/da389d6c06a51b14f24eb4433de96424bbab0c6d1f25d0a96ae541ae1b1a7468",
          "currentSnapshotUrl": "https://pricingbrief.com/evidence/24dee6867ea3c9471bb2a041b140acaff1bbb918c5620b8b2a878b8fd4ccdada"
        }
      ]
    }
  ],
  "trustReceipt": {
    "schemaVersion": 1,
    "sourceCitationCoverage": {
      "status": "complete",
      "publishedVendorCount": 3,
      "publishedClaimCount": 8,
      "sourceUrlClaimCount": 8,
      "retainedSnapshotClaimCount": 8
    },
    "correctionPolicy": {
      "contact": "corrections@pricingbrief.com",
      "summary": "Report the issue date, vendor name, source page, and corrected information. PricingBrief investigates and publishes a correction in the next issue if the original was wrong."
    }
  }
}