Copy page

Errors

CATALOGSET_REQUIRED

CATALOGSET_REQUIRED

A new cart must be created against a specific catalog set; the request omitted catalogSetId.

Summary

Field	Value
HTTP status	400
errorCategory	validation
retryable	false

When This Fires

• POST /v1/marketfront/carts/add — the request omitted catalogSetId and no existing cart was supplied. Each cart is bound to one catalog set so subsequent line-item validation and pricing have a stable basis.

Recommended Action

Resolve the catalogSetId from the store you are ordering from and include it on the request:

Code
GET /v1/marketfront/stores/{storeId}

Use the returned catalogSetId on the next cart-add call:

Code
POST /v1/marketfront/carts/add
Authorization: Bearer YOUR_SESSION_TOKEN
Content-Type: application/json

{
  "storeId": "{storeId}",
  "catalogSetId": "{catalogSetId}",
  "item": { ... }
}

Example

Code
{
  "type": "https://developer.gett-tech.com/errors/CATALOGSET_REQUIRED",
  "title": "Bad Request",
  "status": 400,
  "detail": "CatalogSetId is required when creating a new cart",
  "instance": "/v1/marketfront/carts/add",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "CATALOGSET_REQUIRED",
  "errorCategory": "validation",
  "retryable": false
}