OPERATION-551 - List Operation lines

get

https://example.com/v1/shop/operations/{operationId}/lines

Returns the paginated list of product lines (variants) for a single Operation, visible to the caller's account on the effective store.

Feature flag

Requires OPERATIONS to be active.

User scoping

Only ACCOUNT users are allowed.

Store scoping

Effective store is the dj-store header if provided, otherwise the tenant default store.
Caller must be attached to the effective store; otherwise 403.

Visibility

Operation must be ACTIVE and currently in time window (now within [startDate, endDate], inclusive).
PUBLIC: all variants applicable to the caller's account/catalogue view are returned.
PRIVATE: variants are returned only if the caller's account is associated to the Operation and variants are applicable to the account/catalogue view.

Locales

Optional locale query param (IETF, e.g. en-GB). If unknown for the store, the store default locale is used (fallback). Localised fields are returned in singular form (e.g. variantName).

Scope

This endpoint returns Operation lines only (no Operation metadata). Use /v1/shop/operations/{operationId} for Operation details.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

operationId

string

required

External identifier of the Operation.

Query Params

page

int32

size

int32

sort

array of strings

sort

variantIds

array of strings

Filter by a list of variant external identifiers.
Unknown values are ignored.

variantIds

variantName

string

Case-insensitive substring match on variant name (single value).

locale

string

IETF locale key (e.g. en-GB, fr-FR).
Must be part of store-authorised locales; otherwise the store default is used (fallback).

Headers

dj-client

string

enum

required

Specifies the client type making the request.

OPERATOR: Platform operator user.
ACCOUNT: Customer account user.
SUPPLIER: Supplier managing orders.

Allowed:

dj-api-key

string

required

API key required for authentication. Must be valid and linked to the requesting user.

dj-store

string

(Optional) Store ID in multi-store environments.

dj-store-view

string

(Optional) Store view ID in multi-store environments.

customer-account-id

string

(Optional) Customer account ID in multi-account customer user.

Responses

401

Authentication failed. Missing or invalid authentication token.

403

Forbidden. Either unauthorized user type, feature disabled, store membership denied, or Operation not eligible.

404

Operation not found or not visible to the caller on the effective store.

422

Invalid or inconsistent query parameter values.

500

Unexpected server error.

200Paginated list of Operation lines visible to the caller on the effective store.