Get the checkout contract for a country
Public endpoint. Returns everything checkout needs to sell into one country for the store in one cacheable response - the address layout, agreements, payment method order, legal and tax settings, 3DS, customs, ship-from and currency. The company comes from cart_token, else the signed-in caller. With a cart that ships to this country, the agreements and currency are the cart’s own. The ETag equals contract_digest. The response is max-age=0, private, must-revalidate, because the same cart_token URL changes body as the cart changes, so a browser revalidates with the ETag before every use and hands the caller the 200 it holds when nothing changed. A browser caller does not send If-None-Match itself. An HTTP client that does gets a bodyless 304.
curl --request GET \
--url https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"contract": {
"country": {
"iso": "US",
"name": "United States"
},
"currency_code": "USD",
"requires_3ds": false,
"checkout_requires_terms": true,
"address_fields": [
{
"field": "first_name",
"label": "First name",
"required": true,
"local_label": null,
"placeholder": null,
"visible": true,
"column_width": "full",
"order": 1
},
{
"field": "address1",
"label": "Address",
"required": true,
"local_label": null,
"placeholder": null,
"visible": true,
"column_width": "full",
"order": 2
},
{
"field": "postal_code",
"label": "Zip code",
"required": true,
"local_label": null,
"placeholder": null,
"visible": true,
"column_width": "half",
"order": 3
}
],
"address_fields_source": "legacy",
"authored_address_fields_enabled": false,
"recheck_before_payment": false,
"agreements": [
{
"id": 162906953,
"default_checked": false,
"enrollment_pack_id": null,
"required": true,
"show_at_checkout": true,
"show_path": "/api/agreements/162906953",
"standalone_on_checkout": false,
"content_digest": "4f7f9a2d0c6b1e8e3a5d9c7b2f1e0d4c8b6a5f3e2d1c0b9a8f7e6d5c4b3a2918",
"subscription_only": false,
"title": "Terms of Sale - United States"
},
{
"id": 320402186,
"default_checked": false,
"enrollment_pack_id": null,
"required": false,
"show_at_checkout": false,
"show_path": "/api/agreements/320402186",
"standalone_on_checkout": false,
"content_digest": "4f7f9a2d0c6b1e8e3a5d9c7b2f1e0d4c8b6a5f3e2d1c0b9a8f7e6d5c4b3a2918",
"subscription_only": false,
"title": "Privacy Policy"
}
],
"payment_method_priority": [
"CreditCard",
"Paypal"
],
"legal_settings": {
"cooling_off_period_days": null,
"warranty_period_months": null,
"cookie_consent_required": null,
"recurring_subscription_disclosure_required": true,
"order_button_label": null,
"marketing_consent_mode": null
},
"tax": {
"tax_name": "Sales tax",
"tax_inclusive_pricing": false
},
"customs": null,
"ship_from_country_code": "US",
"language_iso": "en",
"contract_digest": "81015d2205eb13ad392cb4fb9b83c4f7e372bd4ea2d3007d2799583c2d21a8c9"
},
"meta": {
"request_id": "aacf44e1-4dde-4feb-807a-d80a28b50392",
"timestamp": "2026-10-02T12:11:29Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}Query Parameters
curl --request GET \
--url https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/checkout/v2026-04/store/contract/{country_code}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"contract": {
"country": {
"iso": "US",
"name": "United States"
},
"currency_code": "USD",
"requires_3ds": false,
"checkout_requires_terms": true,
"address_fields": [
{
"field": "first_name",
"label": "First name",
"required": true,
"local_label": null,
"placeholder": null,
"visible": true,
"column_width": "full",
"order": 1
},
{
"field": "address1",
"label": "Address",
"required": true,
"local_label": null,
"placeholder": null,
"visible": true,
"column_width": "full",
"order": 2
},
{
"field": "postal_code",
"label": "Zip code",
"required": true,
"local_label": null,
"placeholder": null,
"visible": true,
"column_width": "half",
"order": 3
}
],
"address_fields_source": "legacy",
"authored_address_fields_enabled": false,
"recheck_before_payment": false,
"agreements": [
{
"id": 162906953,
"default_checked": false,
"enrollment_pack_id": null,
"required": true,
"show_at_checkout": true,
"show_path": "/api/agreements/162906953",
"standalone_on_checkout": false,
"content_digest": "4f7f9a2d0c6b1e8e3a5d9c7b2f1e0d4c8b6a5f3e2d1c0b9a8f7e6d5c4b3a2918",
"subscription_only": false,
"title": "Terms of Sale - United States"
},
{
"id": 320402186,
"default_checked": false,
"enrollment_pack_id": null,
"required": false,
"show_at_checkout": false,
"show_path": "/api/agreements/320402186",
"standalone_on_checkout": false,
"content_digest": "4f7f9a2d0c6b1e8e3a5d9c7b2f1e0d4c8b6a5f3e2d1c0b9a8f7e6d5c4b3a2918",
"subscription_only": false,
"title": "Privacy Policy"
}
],
"payment_method_priority": [
"CreditCard",
"Paypal"
],
"legal_settings": {
"cooling_off_period_days": null,
"warranty_period_months": null,
"cookie_consent_required": null,
"recurring_subscription_disclosure_required": true,
"order_button_label": null,
"marketing_consent_mode": null
},
"tax": {
"tax_name": "Sales tax",
"tax_inclusive_pricing": false
},
"customs": null,
"ship_from_country_code": "US",
"language_iso": "en",
"contract_digest": "81015d2205eb13ad392cb4fb9b83c4f7e372bd4ea2d3007d2799583c2d21a8c9"
},
"meta": {
"request_id": "aacf44e1-4dde-4feb-807a-d80a28b50392",
"timestamp": "2026-10-02T12:11:29Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"code": "<string>",
"blocked_date": "2026-11-30",
"blocked_day": 30,
"allowed_date": "2026-11-28",
"scheduled_date": "2026-12-10",
"last_bill_date": "2026-11-10",
"requested_date": "2026-11-30",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}