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
}
],
"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,
"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,
"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"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Bearer token authentication
Path Parameters
ISO country code, any case
Query Parameters
The cart whose company the contract is for.
Language for labels and names. Defaults to the cart's language, then English.
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
}
],
"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,
"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,
"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"
}
}{
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}