OPERATION-500 - Return a single Operation by ID

Returns the details of 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 are visible to all accounts on the effective store.
  • PRIVATE require an explicit association with the caller's account.
  • If the Operation is not visible under these rules, the API returns 404.

Locales

  • Optional locale query param (IETF, e.g. en-GB). If unknown for the store, the store default locale is used (fallback).

Scope

  • This endpoint returns Operation metadata only (no product lines). Use /v1/shop/operations/{operationId}/lines for items.
Language
Credentials
Bearer
JWT
Click Try It! to start a request and see the response here!