Retrieve the list of Audit logs

GET /v2/audits
Bearer auth

Audit logs are created when enabled on calculation requests. Using this endpoint you can retrieve the list of audit logs for the authenticated client.

Note: to use this feature you need to have it enabled for your account, please contact us for more information.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • id string(uuid)

      A unique identifier for the audit, represented as a universally unique identifier (UUID)

    • calculated_at string(date-time)

      The date of the calculation requested.

    • request object

      The item from the request body used for the calculation. The stucture of this property may vary based on the parameters of the calculation request.

      Additional properties are allowed.

    • response object

      The calculation results provided in the response by SQUAKE.

      Additional properties are allowed.

    • calculation object

      More details information like the distance and the emission factors used during the calculation. To have this feature enabled, please contact SQUAKE support

      Additional properties are allowed.

      Hide calculation attributes Show calculation attributes object
      • distance object

        The distance used for the calculation.

        Additional properties are allowed.

        Hide distance attributes Show distance attributes object
        • corrected object

          Additional properties are allowed.

          Hide corrected attributes Show corrected attributes object
          • distance number
          • distance_unit string

            SQUAKE uses common distance units

            Values are meter, kilometer, feet, mile, or nautical_mile. Default value is kilometer.

        • original object

          Additional properties are allowed.

          Hide original attributes Show original attributes object
          • distance number
          • distance_unit string

            SQUAKE uses common distance units

            Values are meter, kilometer, feet, mile, or nautical_mile. Default value is kilometer.

      • emission_factors object

        The emission factors used during the calculation. This object can contain various factors, which will differ from methodology to methodology.

        Additional properties are allowed.

    • methodology object

      Information about the methodology used for the calculation.

      Additional properties are allowed.

      Hide methodology attributes Show methodology attributes object
      • name string

        Name of the methodology used for the calculation.

      • version string

        Version of the methodology used for the calculation.

      • source string

        URL linking to the official documentation or source of the methodology used in the calculation.

    • audit_for object

      If you make a calculation on behalf of a specific legal entity, you can specify their details here.

      Additional properties are allowed.

      Hide audit_for attributes Show audit_for attributes object
      • legal_name string Required

        Legal name of the entity you're performing calculation for.

      • external_id string(email)

        External id of the entity you're performing audit for.
GET /v2/audits 
curl \
 --request GET https://api.squake.earth/v2/audits \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
[
  {
    "id": "0194d6b4-8711-7873-899d-c8133cd742f8",
    "request": {
      "type": "flight",
      "origin": "SAF",
      "destination": "ATL",
      "methodology": "ICAO"
    },
    "response": {
      "carbon_unit": "kilogram",
      "carbon_quantity": 302.75
    },
    "methodlogy": {
      "name": "ICAO",
      "source": "https://applications.icao.int/icec/Methodology%20ICAO%20Carbon%20Emissions%20Calculator_v13_Final.pdf",
      "version": "1.0"
    },
    "calculation": {
      "distance": {
        "original": {
          "distance": 3437.83,
          "distance_unit": "kilometer"
        },
        "corrected": {
          "distance": 3438,
          "distance_unit": "kilometer"
        }
      },
      "emission_factors": {
        "flight_type": "long_haul",
        "co2_per_passenger": 0.5
      }
    },
    "calculated_at": "2025-02-18T16:39:10Z"
  }
]