OPERATION-550 - List ACTIVE Operations visible to the caller

Returns the list of ACTIVE Operations 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

  • Only Operations with status ACTIVE and currently in time window are returned (now within [startDate, endDate], inclusive).
  • PUBLIC are visible to all accounts on the store.
  • PRIVATE require an explicit association with the caller's account.

Locales

  • Optional locale query param. If unknown for the store, the store default locale is used (fallback).

Filters

  • AND between different filter keys, OR between values of the same key. Unknown values are ignored.
  • If a date To is earlier than its corresponding From, the pair is ignored.

Sorting

  • Multiple sort criteria supported among createdAt, startDate, endDate, name.
  • Default: startDate:asc, then name:asc as implicit tie-breaker.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int32
int32
sort
array of strings
sort
ids
array of strings

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

ids
string

Case-insensitive substring match on Operation name.

date-time

Return Operations starting on or after this ISO date (inclusive).

date-time

Return Operations starting on or before this ISO date (inclusive).

date-time

Return Operations ending on or after this ISO date (inclusive).

date-time

Return Operations ending on or before this ISO date (inclusive).

string

Desired locale for translated fields.

  • Must be one of the locales authorised for the effective store.
  • If unknown, fallback is the store default locale.
Headers
string
enum
required

Specifies the client type making the request.

  • OPERATOR: Platform operator user.

  • ACCOUNT: Customer account user.

  • SUPPLIER: Supplier managing orders.

Allowed:
string
required

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

string

(Optional) Store ID in multi-store environments.

string

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

string

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

Responses

401

Authentication failed. Missing or invalid authentication token.

403

Forbidden.

  • Unauthorized client value
  • Permission denied: caller not attached to effective store or lacks visibility
  • Feature disabled
422

Invalid or inconsistent query parameter values (e.g., date ranges).

500

Unexpected server error.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*