Validation Findings

When a feed is connected to a channel (Google, Commission Junction), the feed is validated against that channel’s requirements. Findings tell you what’s wrong and why — the issues that would cause products to be rejected or warned. Use them to drive feed optimization: read the findings, fix them with rules or product overrides, then re-read until clean.

All endpoints are scoped to a feed and a channel, addressed by the channel’s slug (e.g. google, commission_junction). Fetch the connectable channels and their slugs from GET /v1/channels.

---

List findings

Returns the channel’s validation findings as a flat array of issue categories. Each entry is an issue type with the number of affected products and up to ~5 sample rows. The complete row-level list is available via Export findings.

Reading this triggers (re)validation when the channel has never been validated or its configuration changed since the last run — watch meta.revalidating and poll until it is false for up-to-date findings. Channels without a validator return meta.status: "unsupported" and an empty array.

Required scope: read_feeds

Severity sub-collections

Path	Returns
/findings	All findings.
/findings/errors	Only error-severity findings.
/findings/warnings	Only warning-severity findings.

Parameters

Parameter	Type	Description
category	string	Narrow to a single finding category.
page	integer	Page number (default 1).
per_page	integer	Results per page (default 25, max 100).

Request

curl https://app.simpleproductfeeds.com/v1/feeds/feed_1/channels/google/findings/errors \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

Response

{
  "data": [
    {
      "object": "finding",
      "category": "Invalid Link URL",
      "severity": "error",
      "field": "link",
      "affected_count": 634,
      "samples": [
        {
          "row_id": "shopify_US_8012345678901_44012345678901",
          "message": "Link URL is not a valid absolute URL.",
          "field_value": "/products/blue-t-shirt",
          "shopify_admin_url": "https://admin.shopify.com/store/my-store/products/8012345678901"
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1,
    "has_more": false,
    "status": "errors",
    "errors_count": 634,
    "warnings_count": 1902,
    "validated_at": "2026-03-09T14:30:00Z",
    "revalidating": false
  }
}

Finding fields

Meta fields

Errors

Status	Code	Description
404	resource_not_found	The feed does not exist, or the channel is not connected to it.

---

Mute a finding

Suppresses a specific finding (by category + field + row_id) from the active report — useful for known-acceptable issues so the error signal stays actionable. Idempotent on that triple.

Expiry is expressed as muted_until (an absolute timestamp; null means permanent) in the response. On input you can provide muted_until directly, or a convenience duration / days; precedence is muted_until > duration > days, defaulting to permanent.

Required scope: write_feeds

Parameters

Parameter	Type	Required	Description
category	string	Yes	The finding category to mute.
field	string	No	The field the finding applies to.
row_id	string	No	A specific product row to mute.
muted_until	string	No	Absolute expiry (ISO 8601).
duration	string	No	Relative expiry: 30d, 90d, or permanent.
days	integer	No	Relative expiry in days.

Request

curl -X POST https://app.simpleproductfeeds.com/v1/feeds/feed_1/channels/google/finding_mutes \
  -H "Authorization: Bearer spf_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"category": "Missing Units", "field": "shipping_weight", "row_id": "shopify_US_801...", "duration": "30d"}'

Response

{
  "data": {
    "id": 14,
    "object": "finding_mute",
    "category": "Missing Units",
    "field": "shipping_weight",
    "row_id": "shopify_US_801...",
    "muted_until": "2026-04-08T14:30:00Z",
    "created_at": "2026-03-09T14:30:00Z"
  }
}

---

Remove a mute

Deletes a mute, un-suppressing its finding. Returns 204 No Content.

Required scope: write_feeds

curl -X DELETE https://app.simpleproductfeeds.com/v1/feeds/feed_1/channels/google/finding_mutes/14 \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

---

Export findings

Triggers an asynchronous CSV export of the full row-level findings for a channel (the list endpoint only returns aggregated categories with a few samples). Optionally narrow the export to specific categories; omit categories to export all. Repeat requests with the same filter reuse the in-flight export.

Poll Get export status until status is ready, then download from download_url.

Required scope: write_feeds

Parameters

Parameter	Type	Description
categories	array	Optional list of { "category": "...", "field": "..." } objects to narrow the export. Omit for all.

Request

curl -X POST https://app.simpleproductfeeds.com/v1/feeds/feed_1/channels/google/findings_exports \
  -H "Authorization: Bearer spf_live_sk_your_key_here"

Response

{
  "data": {
    "id": 8,
    "object": "findings_export",
    "status": "pending",
    "row_count": null,
    "download_url": null,
    "error": null
  }
}

---

Get export status

Polls an export. Once status is ready, download_url is a time-limited link to the CSV.

Required scope: read_feeds

Response

{
  "data": {
    "id": 8,
    "object": "findings_export",
    "status": "ready",
    "row_count": 2560,
    "download_url": "https://files.simpleproductfeeds.com/findings/...csv?signature=...",
    "error": null
  }
}

Export status values

Status	Description
pending	Queued, not started.
processing	The export is being generated.
ready	Complete; download_url is available.
failed	Generation failed; see error.