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.

    • response object

      The calculation results provided in the response by SQUAKE.

    • 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

      Hide calculation attributes Show calculation attributes object
      • distance object

        The distance used for the calculation.

        Hide distance attributes Show distance attributes object
        • corrected object
          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
          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.

    • methodology object

      Information about the methodology used for the calculation.

      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.

      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"
  }
]