List Feeds

GET /v1/feeds

Retrieve a paginated list of all feeds for your merchant. Results are ordered by creation date, newest first.

Request

Headers

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

Query Parameters

Parameter	Type	Required	Default	Description
page	integer	No	0	Page number (0-based).
size	integer	No	20	Number of feeds per page. Min: 1, Max: 100.
status	string	No	—	Filter by status: PENDING, PROCESSING, ACTIVE, or ERROR.

Example Requests

List all feeds:

curl -X GET 'https://api.violet.io/v1/feeds?page=0&size=20' \
  -H 'Authorization: Bearer msk_12345abc11094a44800d84017c593e22'

List only active feeds:

curl -X GET 'https://api.violet.io/v1/feeds?status=ACTIVE' \
  -H 'Authorization: Bearer msk_12345abc11094a44800d84017c593e22'

Response

200 OK

{
  "feeds": [
    {
      "feed_id": "cat_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "feed_name": "Summer 2024 Product Catalog",
      "feed_type": "CATALOG",
      "upload_method": "FILE_UPLOAD",
      "status": "ACTIVE",
      "product_count": 1250,
      "file_size": 2048576,
      "date_created": "2024-03-15T10:30:00Z",
      "date_last_modified": "2024-03-15T10:45:00Z",
      "error_count": 5,
      "merchant_id": 12345
    },
    {
      "feed_id": "inv_b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "feed_name": "Daily Inventory Update",
      "feed_type": "INVENTORY",
      "upload_method": "FILE_UPLOAD",
      "status": "PROCESSING",
      "product_count": 500,
      "file_size": 512000,
      "date_created": "2024-03-15T09:15:00Z",
      "date_last_modified": "2024-03-15T09:15:00Z",
      "parent_feed_id": "cat_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "error_count": 0,
      "merchant_id": 12345
    }
  ],
  "pagination": {
    "current_page": 0,
    "page_size": 20,
    "total_elements": 45,
    "total_pages": 3,
    "is_first": true,
    "is_last": false,
    "has_next": true,
    "has_previous": false
  }
}

Feed Fields

Field	Type	Description
feed_id	string	Unique feed identifier.
feed_name	string	Human-readable feed name.
feed_type	string	CATALOG or INVENTORY.
upload_method	string	FILE_UPLOAD, URL_SYNC, or SFTP_UPLOAD.
status	string	Current processing status.
product_count	integer	Number of products in this feed.
file_size	integer	File size in bytes.
date_created	string (ISO 8601)	When the feed was created.
date_last_modified	string (ISO 8601)	When the feed was last modified.
parent_feed_id	string	Parent catalog feed ID (inventory feeds only).
error_count	integer	Number of processing errors.
merchant_id	integer	Merchant ID.

Pagination

Field	Type	Description
current_page	integer	Current page number (0-based).
page_size	integer	Number of items per page.
total_elements	integer	Total number of feeds across all pages.
total_pages	integer	Total number of pages.
is_first	boolean	Whether this is the first page.
is_last	boolean	Whether this is the last page.
has_next	boolean	Whether a next page exists.
has_previous	boolean	Whether a previous page exists.

Error Responses

400 Bad Request — Invalid filter or pagination parameters.

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid status filter. Must be one of: PENDING, PROCESSING, ACTIVE, ERROR",
  "timestamp": "2024-03-15T10:30:00Z"
}