HomeGuidesAPI ReferenceRelease Notes
Log In
API Reference

ADM-OPERATION-552 - Get accounts linked to a PRIVATE Operation

get
https://example.com/v1/operations//accounts

Returns the list of accounts associated to a PRIVATE Operation.

Feature flag

  • Requires OPERATIONS to be active.

Access control

  • OPERATOR: can view accounts for any PRIVATE Operation.
  • ACCOUNT: can view accounts only for Operations they own (ownerId = customerUserId), with OPERATIONS_READ permission, and attached to the effective store.

Filters

  • Optional filters: accountId (list of external ids), accountName (contains, case-insensitive).

Sorting

  • Default sort is accountName ASC.
  • Other possible sorts: accountName, accountId.
  • Multiple sorts allowed (comma separated).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique identifier of the Operation (must be PRIVATE)

Query Params
int32
int32
sort
array of strings
sort
accountIds
array of strings

Filter by a list of external account identifiers.

accountIds
string

Filter by account name (case-insensitive substring).

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.

Responses

400

Invalid query parameter format.

401

Unauthorized. Missing or invalid authentication token.

403

Forbidden.

  • Unauthorized client or missing rights (requires OPERATIONS_READ, ownership, or store attachment)
  • Operation type is PUBLIC (only PRIVATE Operations expose accounts list)
  • Feature disabled
404

Operation not found.

500

Unexpected server error.

Updated 7 months ago

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

Updated 7 months ago