Retrieve a specific Audit log

Retrieve Specific Audit Log

The Audit Log Details API lets you fetch full details for a single audit log created by an audited calculation request.

Endpoint

GET /v2/audits/{id}

Retrieve detailed information for a specific audit log.

Authentication

  • Bearer Token required.

  • Audit logging must be enabled for your account.

Path Parameters

Name
Type
Required
Description

id

string (UUID)

βœ…

Unique identifier of the audit log to retrieve.

Response

200 OK β€” Example

{
  "id": "0194d6b4-8711-7873-899d-c8133cd742f8",
  "calculated_at": "2025-02-18T16:39:10Z",
  "request": {
    "type": "flight",
    "methodology": "ICAO",
    "origin": "SAF",
    "destination": "ATL"
  },
  "response": {
    "carbon_quantity": 302.75,
    "carbon_unit": "kilogram"
  },
  "calculation": {
    "distance": { "...": "..." },
    "emission_factors": { "...": "..." }
  },
  "methodology": {
    "name": "ICAO",
    "version": "1.0",
    "source": "https://applications.icao.int/icec/Methodology%20ICAO%20Carbon%20Emissions%20Calculator_v13_Final.pdf"
  },
  "audit_for": "d3427e0d-5a3c-40ce-842e-5552e77caa4f"
}

Field Reference

  • id (UUID) β€” Unique audit log ID.

  • calculated_at (ISO 8601) β€” When the calculation was performed.

  • request β€” Exact request item used for the audited calculation (structure varies by activity).

  • response β€” Calculation result (e.g., carbon_quantity, carbon_unit).

  • calculation β€” Additional details such as distance resolution and emission factors (feature-gated; contact support to enable).

  • methodology β€” Methodology name, version, and official source link used for the calculation.

  • audit_for β€” ID of an Auditable entity the audit log is associated with (set via audit_for on the calculation request).

Errors

Status
Meaning

200

Success

403

Authentication/authorization failed

404

Audit log not found

cURL

curl --request GET "https://api.squake.earth/v2/audits/{id}" \
  --header "Authorization: Bearer $ACCESS_TOKEN"

Last updated

Was this helpful?