Method list

Test your request

Changelog

Returns a list of log entries for a given purchase order, allowing to track status changes, item modifications, and other events.

purchase_order_id	int	Purchase order (delivery) identifier.
date_from	int	(optional) Date from which logs are to be retrieved. Unix timestamp format.
date_to	int	(optional) Date to which logs are to be retrieved. Unix timestamp format.
log_type	array	(optional) Array of event type IDs you want to retrieve. Available values: 0 - Purchase order creation 1 - Purchase order deletion 2 - Status change 3 - Email sent to supplier 4 - Text field modifications 5 - Items modifications 6 - Landed costs modifications 7 - Packages modifications 8 - Shared via supply page 9 - Item negotiations 10 - Purchase order merge 11 - Purchase order split
sort	varchar(4)	(optional) Log sorting direction. Default: "ASC".
page	int	(optional) Results paging (100 log groups per page).

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
logs	array	An array of logs grouped by date and the profile executing the change.
| - profile	text	The name of the profile that performed the change.
| - date	int	Event date (unix timestamp).
| - entries	array	An array of events performed by a given profile at a given time. log_type (text) - Event type key. Possible values: "purchase_order_creation" "purchase_order_deletion" "status_change" "email_sent_to_supplier" "text_field_modification" "items_modification" "landed_costs_modification" "packages_modification" "shared_via_supply_page" "item_negotiations" "purchase_order_merge" "purchase_order_split". status_key (text) - New status key. Returned only for log_type "status_change". Possible values: "draft", "sent", "received_not_started", "received", "completed", "completed_partially", "canceled". field_key (text) - Modified field key. Returned only for log_type "text_field_modification". Possible values: "name", "status", "full_number", "notes". previous_value (text) - Previous value of the modified text field. Returned only for log_type "text_field_modification". email_recipient (text) - Email recipient. Returned only for log_type "email_sent_to_supplier". items_changes_count (int) - Number of item modifications grouped in this log entry. Returned only for log_type "items_modification". landed_costs_changes_count (int) - Number of landed costs modifications grouped in this log entry. Returned only for log_type "landed_costs_modification". packages_changes_count (int) - Number of packages modifications grouped in this log entry. Returned only for log_type "packages_modification". item_negotiations_count (int) - Number of negotiation changes grouped in this log entry. Returned only for log_type "item_negotiations". related_purchase_order_id (int) - Identifier of the related purchase order. Returned only for log_type "purchase_order_merge" or "purchase_order_split". related_purchase_order_full_number (text) - Full number of the related purchase order. Returned only for log_type "purchase_order_merge" or "purchase_order_split".

Input data:
{ "purchase_order_id": 456, "date_from": 1700000000 } Output data:
{ "status": "SUCCESS", "logs": [ { "profile": "John Smith", "date": 1700000100, "entries": [ { "log_type": "status_change", "status_key": "received_not_started" } ] }, { "profile": "Jane Doe", "date": 1700000500, "entries": [ { "log_type": "items_modification", "items_changes_count": 3 }, { "log_type": "text_field_modification", "field_key": "notes", "previous_value": "Old notes" } ] }, { "profile": "API", "date": 1700000900, "entries": [ { "log_type": "purchase_order_merge", "related_purchase_order_id": 123, "related_purchase_order_full_number": "PO/2026/05/0001" } ] } ] } A sample request in PHP:
<?php $methodParams = '{ "purchase_order_id": 456, "date_from": 1700000000 }'; $apiParams = [ "method" => "getInventoryPurchaseOrderLogs", "parameters" => $methodParams ]; $curl = curl_init("https://api.baselinker.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);