# Perform a Calculation including a Price Quote

Convenience all-in-one endpoint to perform carbon calculation
and pricing. A purchase can be performed via API or SQUAKE's checkout page
using the returned .

All features supported by either the  or  endpoint
are equally valid for this combined endpoint. Please read the respective descriptions
for details.

If you need only either pricing or carbon emissions, SQUAKE advises using
the specific endpoints for lower latency and reduced implementation complexity.'


Endpoint: POST /v2/calculations-with-pricing
Security: Bearer-Auth

## Request fields (application/json):

  - `expand` (array)
    If you choose to expand on e.g. "items", SQUAKE returns emissions per each item separately (in addition to a total value). If you include  a pricing token will be returned for each item.
    Enum: "items", "product", "price", "items.pricing"

  - `items` (array, required)

  - `product` (string, required)

  - `payment_link_return_url` (string)
    If the customer does not exit the browser after the purchase, on success, SQUAKE will redirect the customer to this link.

  - `currency` (string)
    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"

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

  - `distance_unit` (string)
    SQUAKE uses common distance units
    Enum: "meter", "kilometer", "feet", "mile", "nautical_mile"

  - `payment_method` (string)
    Controls the way you want to process the purchase.

If  is used then you''ll receive a  in response.

If  is used, then you''ll have to use  endpoint to finalise the purchase.
    Enum: "stripe", "batch_settlement"

## Response 200 fields (application/json):

  - `id` (string, required)
    A token encoding the pricing. Used to make a purchase.

  - `carbon_quantity` (number, required)

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

  - `payment_link` (string)

  - `price` (any, required)

  - `product` (any, required)

  - `valid_from` (string, required)
    Date in ISO 8601 notation.

  - `valid_until` (string, required)
    Date in ISO 8601 notation.

  - `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.

  - `items` (array)
    Expand items to receive emissions per item. By default, this is not included.

  - `items.external_reference` (string)

  - `items.type` (string, required)
    Enum: "accommodation", "air_freight", "bus", "camping_site", "car", "co2_amount", "coffee_production", "cruise", "expenditure", "ferry", "flight", "general", "hotel", "logistics", "logistics_site", "money_amount", "private_jet", "sea_freight", "inland_waterways", "train", "rail_freight", "road_freight", "van"

  - `items.methodology` (string, required)
    Enum: "ACRISS", "ADEME", "BASIC", "CLEAN-CARGO", "CO2-EMISSIEFACTOREN-NL", "DIN-EN-16258", "DEFRA", "EU-EEA", "EU-EMSA", "US-EPA", "HCMI", "OFNK", "ECTA", "GLEC", "ICAO", "TIM", "SQUAKE"

  - `items.pricing` (object)
    Only included if  includes

## 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)