Catalog Feeds
The Feeds API lets you upload, manage, and monitor product catalog feeds. Feeds are processed asynchronously — after you upload a feed file, it is validated, parsed, and transformed into standardized product offers.
Base URL: https://api.violet.io
Authentication
All requests require a merchant API key passed as a Bearer token in the Authorization header.
Authorization: Bearer msk_{merchant_id}{uuid}API keys follow the pattern msk_ + your numeric merchant ID + a 32-character UUID. For example, if your merchant ID is 12345:
Authorization: Bearer msk_12345abc11094a44800d84017c593e22The service extracts your merchant ID from the key automatically. You do not need to pass it separately.
Endpoints
Feed Statuses
A feed progresses through these statuses during its lifecycle:
PENDING
The feed has been uploaded and is waiting for processing to start.
PROCESSING
The feed is currently being processed (parsed, validated, transformed).
ACTIVE
Processing completed successfully. Products are available.
ERROR
Processing failed. Check the errors array on the feed details for specifics.
Error Response Format
All error responses follow the same structure:
code
string
Machine-readable error code.
message
string
Human-readable error description.
timestamp
string (ISO 8601)
When the error occurred.
HTTP Status Codes
200 OK
Request succeeded.
202 Accepted
Request accepted; processing started asynchronously.
400 Bad Request
Invalid parameters or validation failure.
401 Unauthorized
Invalid API credential.
403 Forbidden
Attempting to access an unpermitted resource.
404 Not Found
Feed not found or not accessible for your merchant.
413 Payload Too Large
File exceeds the 2 GB size limit.
500 Internal Server Error
Unexpected server error.
Last updated
Was this helpful?

