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.
Headers
| Field | Type | Description |
|---|---|---|
X-Language
|
string | Language for translated content, as an ISO 639-1 code ("sv", "en"). Omitting it answers in the channel's default language, and so does a language the channel does not publish — this never fails the request. The channel decides which languages exist; read them from the session response. |
Responses
200
EcomSessionResponse
| Field | Type | Description |
|---|---|---|
cartItemCount
|
integer | |
channel
|
SessionChannel | |
customer
|
SessionCustomer | |
environmentLabel
|
string · nullable | |
expiresAt
|
string(date-time) | |
impersonation
|
SessionImpersonation | Vem som öppnat den här sessionen som kunden. |
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" \
-H "X-Language: …"
Response 200
{
"cartItemCount": 42,
"channel": {
"analytics": {
"analyticsEnabled": true,
"customHeadScript": "string",
"enhancedConversionsEnabled": true,
"facebookPixelId": "string",
"googleAdsConversionId": "string",
"googleAdsPurchaseLabel": "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",
"imageBackground": "string",
"logoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"primaryColor": "string",
"primaryHoverColor": "string",
"secondaryColor": "string",
"storeName": "Fluit",
"textColor": "string"
},
"businessProfile": {
"city": "Stockholm",
"companyName": "Acme AB",
"countryCode": "SE",
"email": "order@acme.se",
"latitude": "299.00",
"longitude": "299.00",
"openingHours": [
{
"closes": "string",
"days": [
"string"
],
"opens": "string"
}
],
"organizationNumber": "ABC-001",
"phone": "+46 8 123 45 67",
"postalCode": "11122",
"schemaType": "string",
"showInFooter": true,
"streetAddress": "string"
},
"code": "string",
"currency": "string",
"features": {
"allowBackorderChoice": true,
"allowBackorders": true,
"allowCustomerVatToggle": true,
"allowRequestedDeliveryDate": true,
"commerceEnabled": true,
"enableAddToCartModal": true,
"enableChatAssistant": true,
"guestCheckout": true,
"minimumOrderValue": "299.00",
"requireLogin": true,
"showCrossReferences": true,
"showListPriceAndDiscount": true,
"showLowestPrice30Days": true,
"showOutOfStockProducts": true,
"showPricesIncludingVat": true,
"showPricesWithoutLogin": true,
"showSku": true,
"showStock": true,
"stockAggregation": "string"
},
"language": "string",
"languages": [
{
"code": "string",
"name": "White",
"nativeName": "White"
}
],
"name": "Acme AB",
"navigation": {
"catalogMenuDepth": 42,
"catalogMenuLabel": "string",
"catalogMenuMode": "string",
"catalogMenuSortOrder": 42,
"catalogRootCategoryId": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
"chrome": {
"footerLogoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"footerNewsletter": {
"isEnabled": true,
"text": "string",
"title": "string"
},
"headerLayout": "string",
"logoSize": "string",
"mobileActionBar": {
"buttons": [
{}
],
"isEnabled": true
},
"mobileSearch": "string",
"showLogoInFooter": true
},
"footerColumns": [
{
"html": "string",
"links": [
{}
],
"sortOrder": 42,
"title": "string"
}
],
"promiseBar": {
"isEnabled": true,
"items": [
{
"icon": "string",
"text": "string"
}
],
"narrowBehavior": "string",
"tone": "string"
},
"reservedSlugs": [
"string"
],
"showCategorySidebar": true,
"socialLinks": [
{
"platform": "string",
"sortOrder": 42,
"url": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}
],
"topMenuLinks": [
{
"children": [
null
],
"label": "string",
"openInNewTab": true,
"showAsButton": 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
}
},
"productCard": {
"hover": "string",
"imageFit": "string",
"imageRatio": "string",
"keySpecRows": 42,
"mobileColumns": 42,
"showAddToCart": true,
"showBrand": true,
"showCompare": true,
"showStock": true,
"showVatNote": true
},
"seo": {
"baseUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"metaDescription": "string",
"metaTitle": "string",
"redirectToPrimaryDomain": true,
"robotsTxtExtra": "string",
"searchEngineIndexingEnabled": true
},
"type": "string"
},
"customer": {
"canPlaceOrders": true,
"email": "order@acme.se",
"id": "string",
"name": "Acme AB"
},
"environmentLabel": "string",
"expiresAt": "2026-06-11T09:24:13.418",
"impersonation": {
"by": "string",
"startedAt": "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.