Retrieve Products

GET /v2/products

A product is any purchasable compensation option SQUAKE offers. In the simplest case, a product maps to a single climate project such as "Sustainable Biofuel for Shipping". Depending on client need, SQUAKE also offers bundles of multiple climate projects; these can be centered around specific goals, e.g.,"carbon reduction", "location", or what is desired to achieve a particular price point or sustainability goal. Feel free to contact us for more information or custom products.

Query parameters

  • locale string

    Descriptions of products can be localized.

    Minimum length is 2, maximum length is 5. Format should match the following pattern: ^(?:[a-z]{2}|[a-z]{2}-[A-Z]{2})$. Values are de, en, es, fr, hi, it, ja, pt, pt-BR, or zh-CN. Default value is en.

  • page number

    An optional parameter that enables pagination, by default the amount of items per page is 25

    Minimum value is 1.

  • items number

    An optional parameter that enables pagination, this controls the amount of items per page. Can be used separetly or in conjunction with page

    Minimum value is 1, maximum value is 25.

  • category string

    Allows filtering of the categories of a product, filters by code

  • class string

    Allows filtering of the classes of a product, filters by code

  • Allows filtering of the impact types of a product, filters by code

Responses

  • 200 application/json

    OK

    Hide headers attribute Show headers attribute
    • Unique identifier linked to this API request. If you need to contact us regarding a specific request, providing the request identifier helps the resolution process.

    Hide response attributes Show response attributes object
    • id string Required

      Format should match the following pattern: product_[A-Za-z0-9]*.

    • locations array[object]

      List of all locations impacted by the projects used in this product.

      Hide locations attributes Show locations attributes object
      • country string Required

        Two-letter or three-letter code as defined in ISO 3166-1 alpha-2 and alpha-3 respectively.

        Minimum length is 2, maximum length is 3. Format should match the following pattern: ^[A-Z]{2,3}$.

      • One to Three-digit UN M49 sub region code.

      • region string

        One to Three-digit UN M49 region code.

    • certifications array[string]

      Certification organizations rate and evaluate the quality of emitted carbon credits; such organizations assess, for example, the inclusion of safeguarding principles, the impact of climate and sustainable development goals, or the presence of a monitoring plan.

      Values are American Carbon Registry, Australian Biodiversity Unit, BAFU VER, Clean Development Mechanism, DNV, Ernst & Young, European Biochar Certification, Gold Standard CER, Gold Standard VER, I-REC, International Sustainability & Carbon Certification (ISCC), ISO 14064, Moor Futures, Müller BBM, Plan Vivo, TÜV, or Verified Carbon Standard.

    • title string

      A short human readable summary of the description.

    • A human readable description.

    • sdgs array[integer]

      The Sustainable Development Goals (SDGs) aim to transform our world. They are a call to action to end poverty and inequality, protect the planet, and ensure that all people enjoy health, justice and prosperity.

      Minimum value of each is 1, maximum value of each is 17.

    • files array[object]

      Images attached to the product.

      Hide files attributes Show files attributes object
      • id string Required

        Format should match the following pattern: file_[A-Za-z0-9]*.

      • filename string Required
      • purpose string Required

        Values are confirmation_document, certificate_document, or project_image.

      • size integer Required

        Byte size of the object

      • type string Required

        Values are csv, jpg, pdf, png, or webp.

      • download_url string(uri)

        The link will expire after 1 year. If blank, the document has not been created yet. Please poll until a link is included.

      • Information pertaining to the file, e.g., when the file will be available

    • prices array[object]

      Multiple prices may exist, for example, when future price changes are already known.

      Hide prices attributes Show prices attributes object
      • id string Required

        Format should match the following pattern: price_[A-Za-z0-9]*.

      • product string Required
      • unit_amount integer(int64) Required

        The total amount in the lower denomination of the currency; e.g. 12.34 USD would be 1234.

      • carbon_unit string Required

        SQUAKE uses The International System of Units (SI), commonly referred to as "metric system".

        Values are tonne, kilogram, or gram.

      • currency string Required

        3-letter ISO 4217 alpha code of the currency.

        Minimum length is 3, maximum length is 3. Format should match the following pattern: ^[A-Z]{3}$. Values are AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BRL, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DZD, EGP, ETB, EUR, GBP, GEL, HKD, HUF, IDR, INR, ISK, JMD, JOD, JPY, KES, KRW, KWD, KZT, LKR, LYD, MAD, MUR, MXN, MYR, NOK, NZD, OMR, PHP, PKR, PLN, QAR, RSD, RUB, SAR, SEK, SGD, SYP, THB, TND, TRY, TTD, TWD, UAH, USD, VND, XAF, XOF, or ZAR. Default value is EUR.

      • valid_from string(date) Required

        Used for TIM, GATE4 and IATA.

        Format should match the following pattern: ^\d{4}-\d{2}-\d{2}$.

    • categories array[object]
      Hide categories attributes Show categories attributes object
      • code string Required

        Unique identifier for a category

        Format should match the following pattern: ^[a-z_]+$.

      • title string

        English human-readable name of the category.

    • impact_types array[object]
      Hide impact_types attributes Show impact_types attributes object
      • code string Required

        Unique identifier for a impact type

        Format should match the following pattern: ^[a-z_]+$.

      • title string

        English human-readable name of the impact type

    • classes array[object]
      Hide classes attributes Show classes attributes object
      • code string Required

        Unique identifier for a project class

        Format should match the following pattern: ^[a-z_]+$.

      • title string

        English human-readable name of the project class

  • 401 application/json

    Example response

    Hide headers attribute Show headers attribute
    • Unique identifier linked to this API request. If you need to contact us regarding a specific request, providing the request identifier helps the resolution process.

      Format should match the following pattern: req_[a-zA-Z0-9-]+.

    Hide response attributes Show response attributes object
    • code string Required

      An application-specific error code, expressed as a string value.

      Values are field_validation_error, server_error, not_authorized, not_found, invalid_methodology, or invalid_type.

    • detail string

      A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

    • source object

      An object containing references to the primary source of the error

      Hide source attributes Show source attributes object
GET /v2/products
curl \
 -X GET https://api.squake.earth/v2/products \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
# Headers

# Payload
[
  {
    "id": "product_2rsg35sfsdf",
    "locations": [
      {
        "country": "DE",
        "sub_region": "150",
        "region": "155"
      }
    ],
    "certifications": [
      "European Biochar Certification"
    ],
    "title": "string",
    "description": "string",
    "sdgs": [
      7
    ],
    "files": [
      {
        "id": "file_asfg454s25",
        "filename": "string",
        "purpose": "confirmation_document",
        "size": 42,
        "type": "pdf",
        "download_url": "https://example.com",
        "notification": "string"
      }
    ],
    "prices": [
      {
        "id": "price_1MMroL2eZvKYlo2CxbxAACvb",
        "product": "prod_N760vOJBvdEDY8",
        "unit_amount": 2500,
        "carbon_unit": "tonne",
        "currency": "EUR",
        "valid_from": "2023-01-28"
      }
    ],
    "categories": [
      {
        "code": "forestry_and_land_use",
        "title": "Forestry and Land Use"
      }
    ],
    "impact_types": [
      {
        "code": "avoidance",
        "title": "Avoidance"
      }
    ],
    "classes": [
      {
        "code": "technology_based",
        "title": "Technology based"
      }
    ]
  }
]
Response examples (401)
# Headers
SQUAKE-Request-Id: req_70394c00-728e-4d70-90bc-2b589c9ebdf8

# Payload
[
  {
    "code": "field_validation_error",
    "detail": "string",
    "source": {
      "id": "string",
      "attribute": "string",
      "model": "string"
    }
  }
]