Method list

Test your request

Changelog

Returns the history of a Listing Agent from the last 14 days: creation, settings changes, enabling, disabling and deletion, with changed fields. Marketplace account settings (default category, price group) are not part of the agent history.

listing_agent_id	int	Listing Agent identifier.
page	int	Results page (100 events per page, numbered from 1).

The method returns the data in JSON format.

status	varchar(30)	SUCCESS - request executed correctly ERROR - an error occurred during an API request. Error details will be described in 2 additional returned fields: error_message and error_code
page	int	The one-based page number returned.
marketplace_code	varchar(50)	Marketplace code of the agent.
events	array	Events ordered by date descending.
| - event	varchar(20)	create, update, disable, delete.
| - triggered_by	varchar(20)	user – changed in the panel or API; system – changed automatically (e.g. disabled after the source was removed); support – changed by Base support.
| - changes	array	Changed settings. Empty for create and delete. Older entries may list only filters, account, source, name, status, site and catalog view. field (varchar(100)) - Setting name as in getListingAgentsData settings, e.g. filters.tag_ids, variants_mode, is_active, account_id. Exceptions: storage_id – raw ID of the agent source (inventory, shop, warehouse or Connect integration ID, see source_type); filters – true or false when filters were switched on or off. before (text) - Previous value encoded as JSON with the type used in getListingAgentsData settings (e.g. "[12]", "true", "\"products\""). after (text) - New value encoded as JSON.
| - date	int	Unix timestamp of the event.

Input data:
{ "listing_agent_id": 4812 } Output data:
{ "status": "SUCCESS", "page": 1, "marketplace_code": "allegro", "events": [ { "event": "update", "triggered_by": "user", "changes": [ { "field": "filters.tag_ids", "before": "[12]", "after": "[12,40]" } ], "date": 1792310000 } ] } A sample request in PHP:
<?php $methodParams = '{ "listing_agent_id": 4812 }'; $apiParams = [ "method" => "getListingAgentSettingsHistory", "parameters" => $methodParams ]; $curl = curl_init("https://api.base.com/connector.php"); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-BLToken: xxx"]); curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($apiParams)); $response = curl_exec($curl);