Get Feed by ID

GET /v1/feeds/{feedId}

Retrieve full details for a specific feed, including processing status, statistics, and any errors encountered.

Request

Headers

Header	Required	Description
Authorization	Yes	Bearer msk_{merchant_id}{uuid}

Path Parameters

Parameter	Type	Required	Description
feedId	string	Yes	The feed identifier. Format: cat_{uuid} or inv_{uuid}.

Example Request

curl -X GET https://api.violet.io/v1/feeds/cat_a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H 'Authorization: Bearer msk_12345abc11094a44800d84017c593e22'

Response

200 OK

{
  "feed_id": "cat_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "merchant_id": 12345,
  "merchant_name": "Acme Electronics",
  "feed_name": "Summer 2024 Product Catalog",
  "description": "Complete product catalog with seasonal items",
  "feed_type": "CATALOG",
  "status": "ACTIVE",
  "upload_method": "FILE_UPLOAD",
  "original_filename": "catalog.xml",
  "file_size_bytes": 2048576,
  "total_products": 1250,
  "date_created": "2024-03-15T10:30:00Z",
  "date_last_processed": "2024-03-15T10:45:00Z",
  "date_last_modified": "2024-03-15T10:45:00Z",
  "processing_stats": {
    "total_products": 1250,
    "successful_products": 1200,
    "failed_products": 50,
    "processing_duration_ms": 45000,
    "processing_started_at": "2024-03-15T10:30:05Z",
    "processing_completed_at": "2024-03-15T10:45:00Z"
  },
  "errors": [
    {
      "error_code": "MISSING_PRICE",
      "message": "Price missing for product ID: ABC123",
      "field": "ABC123",
      "severity": "WARNING",
      "timestamp": "2024-03-15T10:35:00Z",
      "product_id": "ABC123"
    }
  ],
  "configuration": {
    "auto_approve_products": true,
    "enable_inventory_tracking": true,
    "low_stock_threshold": 10,
    "feed_processing_notifications": true,
    "duplicate_product_handling": "MERGE",
    "price_validation_enabled": true,
    "refresh_frequency_minutes": 360,
    "retention_policy_days": 90,
    "default_currency": "USD",
    "default_country": "US",
    "default_language": "en_US",
    "timezone": "America/New_York",
    "removal_detection": {
      "enabled": true,
      "action": "ARCHIVE",
      "bulk_removal_threshold_percent": 50,
      "grace_period_versions": 0,
      "notify_on_removal": true,
      "notify_removal_threshold": 1
    }
  }
}

Response Fields

Field	Type	Description
feed_id	string	Unique feed identifier.
merchant_id	integer	Merchant who owns this feed.
merchant_name	string	Merchant display name.
feed_name	string	Human-readable feed name.
description	string	Optional feed description.
feed_type	string	CATALOG or INVENTORY.
status	string	Current processing status (see Feed Statuses).
upload_method	string	How the feed was uploaded: FILE_UPLOAD, URL_SYNC, or SFTP_UPLOAD.
original_filename	string	Original name of the uploaded file.
file_size_bytes	integer	File size in bytes.
total_products	integer	Total number of products in the feed.
date_created	string (ISO 8601)	When the feed was first created.
date_last_processed	string (ISO 8601)	When the feed was last processed.
date_last_modified	string (ISO 8601)	When the feed was last modified.
parent_feed_id	string	Parent catalog feed ID (only for inventory feeds).
processing_stats	object	Processing performance metrics (see below).
errors	array	List of processing errors and warnings (see below).
configuration	object	Feed configuration settings (see below).

Processing Stats

Field	Type	Description
total_products	integer	Total products processed.
successful_products	integer	Products processed successfully.
failed_products	integer	Products that failed processing.
processing_duration_ms	integer	Total processing time in milliseconds.
processing_started_at	string (ISO 8601)	When processing started.
processing_completed_at	string (ISO 8601)	When processing completed.

Errors

Field	Type	Description
error_code	string	Machine-readable error code (e.g., MISSING_PRICE).
message	string	Human-readable error description.
field	string	Field or product ID where the error occurred.
severity	string	INFO, WARNING, ERROR, or CRITICAL.
timestamp	string (ISO 8601)	When the error was detected.
product_id	string	Product ID associated with the error.

Configuration

Field	Type	Description
auto_approve_products	boolean	Whether products are auto-approved without manual review. Default: true.
enable_inventory_tracking	boolean	Whether inventory levels are tracked. Default: true.
low_stock_threshold	integer	Items below this quantity are considered low stock. Default: 10.
duplicate_product_handling	string	How duplicates are handled: MERGE, SKIP, or REPLACE. Default: MERGE.
price_validation_enabled	boolean	Whether price validation rules are enforced. Default: true.
refresh_frequency_minutes	integer	How often the feed is refreshed, in minutes. Default: 360.
default_currency	string	Default currency code. Default: USD.
default_country	string	Default country code. Default: US.
removal_detection	object	Item removal detection settings (see below).

Removal Detection

Field	Type	Description
enabled	boolean	Whether removal detection is active. Default: true.
action	string	Action for removed items: ARCHIVE, MARK_FOR_REVIEW, or IGNORE. Default: ARCHIVE.
bulk_removal_threshold_percent	integer	If more than this percentage of items are removed, flag for review instead. Default: 50.
grace_period_versions	integer	Number of feed versions an item can be missing before archival. Default: 0.
notify_on_removal	boolean	Whether to send notifications on item removal. Default: true.
notify_removal_threshold	integer	Minimum removed items to trigger a notification. Default: 1.

Error Responses

404 Not Found — No feed with the given ID exists for your merchant.

{
  "code": "FEED_NOT_FOUND",
  "message": "Feed not found or access denied",
  "timestamp": "2024-03-15T10:30:00Z"
}