Skip to main content
GET
Get Purchase Version History
← Purchases API Returns a paginated list of all changes made to a purchase over time, including who made the change, when, and which fields were modified. The history reports the product (description, product_name), purchase_date, expense_type, the spend (quantity, unit_id, price, currency), the physical quantity (non_currency_quantity, non_currency_unit_id), recycled, the supplier (supplier_id, business_name, supplier_country), organization_id, attachment_file_name and the emission factor. A supplier_id change gives the suppliers’ ids and is followed by a supplier change with their names: suppliers of the purchase’s organization or of its group. Any other supplier, and one that no longer exists, is given by its id.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
UUID of the purchase

Query Parameters

integer
default:"1"
Page number (1-based)
integer
default:"50"
Items per page (max 100)

Response

array[object]
Version entries:
integer
Total number of versions
integer
Current page number
integer
Page size

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

404 Not Found

Cause: The purchase does not exist or belongs to another organization

Get Purchase

View current purchase details

Update Purchase

Modify a purchase record