List audit logs

Read the audit logs of your account, one per calculation made in audit mode.

Returns the audit logs of the authenticated client. Each entry is one calculated item that SQUAKE logged in audit mode.

Audit logging must be enabled for your account.

Request

GET /v2/audits

The endpoint takes no parameters.

curl "https://api.sandbox.squake.earth/v2/audits" \
  --header "Authorization: Bearer $SQUAKE_API_KEY"

Response

The body is a JSON array of audit logs. In this example, calculation is shortened. Retrieve an audit log shows it in full.

200 OKapplication/json
[
  {
    "id": "0194d6b5-2c41-7d3a-9f10-5b2e8a7c4d61",
    "calculated_at": "2026-02-27T10:18:58Z",
    "request": {
      "type": "flight",
      "audit": true,
      "methodology": "DEFRA",
      "external_reference": "INV-2025-0211-A",
      "origin": "BER",
      "destination": "CDG",
      "booking_class": "economy",
      "number_of_travelers": 1,
      "aircraft_type": "7M7",
      "radiative_forcing_index": true,
      "sustainable_fuels": { "carbon_reduction_percentage_of_total": 0.25 }
    },
    "response": {
      "carbon_quantity": 81.089,
      "carbon_unit": "kilogram",
      "distance": 928.8,
      "distance_unit": "kilometer"
    },
    "calculation": { "...": "..." },
    "methodology": {
      "name": "DEFRA",
      "version": "1.1_2025",
      "source": "https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2025"
    },
    "audit_for": "d3427e0d-5a3c-40ce-842e-5552e77caa4f"
  },
  {
    "id": "0194d6b4-8711-7873-899d-c8133cd742f8",
    "calculated_at": "2026-03-13T08:02:41Z",
    "request": {
      "type": "flight",
      "methodology": "TIM",
      "external_reference": "ACTIVITY-FLIGHT-OUTBOUND",
      "origin": "BER",
      "destination": "LHR",
      "departure_date": "2026-03-10",
      "airline": "LH",
      "flight_number": "LH2472",
      "booking_class": "economy",
      "number_of_travelers": 1
    },
    "response": {
      "carbon_quantity": 142.6,
      "carbon_unit": "kilogram",
      "distance": 930.0,
      "distance_unit": "kilometer"
    },
    "calculation": { "...": "..." },
    "methodology": {
      "name": "TIM",
      "version": "3.0.0",
      "source": "https://github.com/google/travel-impact-model"
    },
    "audit_for": null
  }
]

The first log comes from the calculation in Audit mode and is linked to an auditable entity. The second belongs to a flight ingested with the Travel Data API and has no entity, so audit_for is null.

FieldTypeDescription
idstring (UUID)Identifier of the audit log.
calculated_atstring (date-time)When SQUAKE performed the calculation.
requestobjectThe item from the request body that was calculated. Its structure depends on the activity type and the methodology.
responseobjectThe result SQUAKE returned, such as carbon_quantity and carbon_unit.
calculationobjectThe distances and emission factors behind the result. Contact SQUAKE support to enable it.
methodologyobjectThe methodology's name, version and source, a link to its official documentation.
audit_forstring | nullID of the auditable entity the log is linked to.

Errors

StatusMeaning
403Authentication or authorization failed. Check that audit logging is enabled for your account.

On this page

GET/v2/audits

Run this request against the sandbox with your test key.

Open in API reference