Get Faire Products Latest Sync Info

GET 
/api/faire/instances/:integrationInstance/products/latest-sync-info

Aggregate stats about the products previously synced from Faire. Used by the Refresh from Faire modal header to show how much data is currently cached locally and which mode of refresh is appropriate.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Path Parameters:

• integrationInstance - The ID of the integration instance

Response Fields:

• latest_product_title - Name of the most recently updated FaireProduct for this instance (null if none synced yet)
• latest_product_date - ISO timestamp of that product's updated_at
• total_products - Count of distinct faire_products rows for this instance
• total_variants - Count of faire_product_options rows for this instance
• mapped_products - Number of variants linked to a product_listings row
• unmapped_products - Variants without a product listing
• last_synced_at - Latest updated_at across all variants
• cursor_at - Stored incremental sync cursor on the integration instance (sync_cursors.products.cursor_at). When null, the Fetch Since Latest Sync mode is unavailable and the user is forced to choose Refetch Entire Catalog or Custom Date Range.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.