GET
/session
Get or create session
Returns a session token and full channel context including branding, features, and analytics. Creates an EcomSession entity on first visit and reuses it on subsequent visits.
Responses
200
EcomSessionResponse
| Field | Type |
|---|---|
cartItemCount
|
integer |
channel
|
SessionChannel |
customer
|
SessionCustomer |
environmentLabel
|
string · nullable |
expiresAt
|
string(date-time) |
isAuthenticated
|
boolean |
isTestEnvironment
|
boolean |
token
|
string · nullable |
429
Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
-
Retry-After— Seconds to wait before retrying.
Standard errors:
404
Errors
Examples
curl
curl "https://api.erp.fluit.cloud/ecom/session" \
-H "Authorization: Bearer $SESSION_TOKEN" \
-H "X-Tenant-Id: $FLUIT_TENANT_ID" \
-H "X-Channel: web"
Response 200
{
"cartItemCount": 42,
"channel": {
"analytics": {
"analyticsEnabled": true,
"customHeadScript": "string",
"facebookPixelId": "string",
"googleAnalyticsId": "string",
"googleTagManagerId": "string"
},
"branding": {
"accentColor": "string",
"accentHoverColor": "string",
"backgroundColor": "string",
"borderRadius": "string",
"customCss": "string",
"faviconUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"fontBody": "string",
"fontHeading": "string",
"footerBackgroundColor": "string",
"footerTextColor": "string",
"headerBackgroundColor": "string",
"headerTextColor": "string",
"logoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"primaryColor": "string",
"primaryHoverColor": "string",
"secondaryColor": "string",
"storeName": "Fluit",
"textColor": "string"
},
"code": "string",
"currency": "string",
"features": {
"allowBackorderChoice": true,
"allowBackorders": true,
"allowCustomerVatToggle": true,
"allowRequestedDeliveryDate": true,
"enableAddToCartModal": true,
"enableChatAssistant": true,
"guestCheckout": true,
"minimumOrderValue": "299.00",
"requireLogin": true,
"showCrossReferences": true,
"showLowestPrice30Days": true,
"showOutOfStockProducts": true,
"showPricesIncludingVat": true,
"showPricesWithoutLogin": true,
"showSku": true,
"showStock": true,
"stockAggregation": "string"
},
"language": "string",
"name": "Acme AB",
"navigation": {
"catalogMenuDepth": 42,
"catalogMenuMode": "string",
"catalogRootCategoryId": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
"footerColumns": [
{
"html": "string",
"links": [
{}
],
"sortOrder": 42,
"title": "string"
}
],
"showCategorySidebar": true,
"socialLinks": [
{
"platform": "string",
"sortOrder": 42,
"url": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}
],
"topMenuLinks": [
{
"label": "string",
"openInNewTab": true,
"sortOrder": 42,
"url": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}
]
},
"policies": {
"applicableCountry": "string",
"productFeedEnabled": true,
"returns": {
"enabled": true,
"generateReturnLabel": true,
"requireReason": true,
"returnInstructions": "string",
"returnWindowDays": 42,
"shippingCost": "string"
},
"shipping": {
"cheapestName": "Parcel, next day",
"cheapestPrice": "299.00",
"freeShippingThreshold": "299.00",
"maxHandlingDays": 42,
"maxTransitDays": 42,
"minTransitDays": 42
}
},
"seo": {
"baseUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"metaDescription": "string",
"metaTitle": "string",
"redirectToPrimaryDomain": true,
"robotsTxtExtra": "string",
"searchEngineIndexingEnabled": true
},
"type": "string"
},
"customer": {
"email": "order@acme.se",
"id": "string",
"name": "Acme AB"
},
"environmentLabel": "string",
"expiresAt": "2026-06-11T09:24:13.418",
"isAuthenticated": true,
"isTestEnvironment": true,
"token": "string"
}Base URL https://api.erp.fluit.cloud/ecom. The response example is generated from the schema: the shape is right, the values are made up.