# Quote a Pricing

Returns pricing for a given product and carbon quantity (or a fixed total amount in any supported currency).

By default, requested pricing is valid for two weeks starting the moment you
request it. Expired pricings can still be used as long as the underlying price
hasn''t changed for your convenience.

Repeated purchases using the same pricing are possible via API and the checkout
page using the pricing id or , respectively.

You can append additional parameters to the ; SQUAKE's checkout
page supports the following:

* : Please use a two-letter ISO 639-1 code, for example: 
for English.

: any valid UTM tracking parameters, e.g., .


This is a low-latency endpoint, useful for previewing pricing before making
a purchase either via API or on the SQUAKE checkout page via the returned
.'


Endpoint: GET /v2/pricing
Security: Bearer-Auth

## Query parameters:

  - `filter` (object)

## Response 200 fields (application/json):

  - `id` (string, required)
    A token encoding the pricing; used to make a purchase. Requests for the same product and carbon quantity (or fixed total) may result in the same id. A pricing is valid for multiple purchases (the purchase endpoint is idempotent if you add an  to the purchase call).

  - `payment_link` (string)

  - `price` (any, required)

  - `product` (any, required)

  - `valid_until` (string, required)
    By default, a price quote is valid from the moment you request it for two weeks. Expired price quotes are accepted if the underlying price hasn't changed.

  - `carbon_quantity` (number, required)
    Volume of carbon emissions

  - `carbon_unit` (string, required)
    SQUAKE uses The International System of Units (SI), commonly referred to as "metric system".
    Enum: "tonne", "kilogram", "gram"

  - `currency` (string, required)
    3-letter ISO 4217 alpha code of the currency.
    Enum: "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", "ZAR"

  - `total` (integer, required)
    The total amount in the lower denomination of the currency; e.g. 12.34 USD would be 1234.

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)