Retrieve a Product

GET /v2/products/{id}

Retrieve details about a specific product

Path parameters

  • id string Required

    The product ID

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.

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

      Additional properties are allowed.

      Hide source attributes Show source attributes object
  • 404 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

      Additional properties are allowed.

      Hide source attributes Show source attributes object
GET /v2/products/{id}
curl \
 -X GET https://api.squake.earth/v2/products/{id} \
 -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"
    }
  }
]
Response examples (404)
# Headers
SQUAKE-Request-Id: req_70394c00-728e-4d70-90bc-2b589c9ebdf8

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