Skip to main content

​
Purchase Tools

Tools for querying Scope 3 purchased goods & services. Each purchase has a product name, quantity, unit, and co2e.

​
list_purchases

Parameters:
ParameterTypeRequiredDescription
organization_idstringNoUUID of the organization
statusstringNoFilter: active, error, deleted
purchase_typestringNoFilter: spend_based, supplier_specific
expense_typestringNoFilter: opex, capex
pageintegerNoPage number (default: 1)
sizeintegerNoResults per page (default: 50)
Example queries: 
"Show our purchases with supplier-specific emission factors"
"Which purchases are in error status?"
"List our capex purchases"
"Show purchases of steel"
Example response: 
{
  "items": [
    {
      "id": "fe4bee9b-...",
      "product_name": "chrome steel",
      "quantity": 100.0,
      "unit": { "name": "metric_tonne_(t)", "type": "solid" },
      "purchase_type": "supplier_specific",
      "expense_type": "opex",
      "status": "active",
      "co2e": 185.4,
      "purchase_date": "2025-08-01"
    }
  ],
  "total": 61764,
  "page": 1,
  "size": 50
}

​
Purchase Types

  • spend_based — Emissions estimated from monetary spend
  • supplier_specific — Emissions from supplier-provided data or custom emission factors

​
Expense Types

  • opex — Operational expenditure
  • capex — Capital expenditure