Get a tenant's public config by domain
curl --request GET \
--url https://api.korint.io/config/by-domain \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.korint.io/config/by-domain"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.korint.io/config/by-domain', 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.korint.io/config/by-domain",
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.korint.io/config/by-domain"
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.korint.io/config/by-domain")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.korint.io/config/by-domain")
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{
"brokerageFirmCustomFields": [
{
"key": "<string>",
"validationRules": [
{
"option": "<string>",
"value": "<string>"
}
],
"integrationKey": "<string>",
"extractionSources": [
"<string>"
],
"extractionFieldKey": "<string>",
"autoFill": {
"enabled": true
}
}
],
"theme": {
"primaryColor": "#00387B",
"logo": "<string>",
"favicon": "<string>",
"logoDark": "<string>",
"secondaryColors": {
"cyan": "#00AEEF",
"red": "#BB1E10"
}
},
"authentication": {
"cognitoUserPoolId": "<string>",
"cognitoUserPoolClientId": "<string>",
"cognitoDomain": "<string>"
},
"tenantName": "<string>",
"availableProductIds": [
"<string>"
],
"tenantId": "<string>",
"speechToText": {},
"externalLinks": [
{
"label": "<string>",
"url": "<string>",
"id": "<string>"
}
],
"previousClaimsPlatformUrl": "<string>",
"displayName": "<string>",
"distributionRequest": {
"approveOnSignature": true,
"contractConfig": {
"templateId": "<string>",
"signature": {
"type": "<string>",
"configName": "<string>",
"signers": [
{
"role": "<string>",
"anchor": {
"page": {},
"x": 123,
"y": 123,
"height": 123,
"width": 123
},
"mentions": [
{
"page": {},
"x": 123,
"y": 123,
"mention": "<string>",
"width": 123
}
],
"texts": [
{
"page": {},
"x": 123,
"y": 123,
"width": 123,
"maxLength": 123,
"question": "<string>",
"height": 123,
"instruction": "<string>",
"optional": true
}
],
"checkboxes": [
{
"page": {},
"x": 123,
"y": 123,
"size": 123,
"name": "<string>",
"optional": true,
"checked": true
}
]
}
],
"anchor": {
"page": {},
"x": 123,
"y": 123,
"height": 123,
"width": 123
},
"mentions": [
{
"page": {},
"x": 123,
"y": 123,
"mention": "<string>",
"width": 123
}
],
"texts": [
{
"page": {},
"x": 123,
"y": 123,
"width": 123,
"maxLength": 123,
"question": "<string>",
"height": 123,
"instruction": "<string>",
"optional": true
}
],
"checkboxes": [
{
"page": {},
"x": 123,
"y": 123,
"size": 123,
"name": "<string>",
"optional": true,
"checked": true
}
]
}
}
},
"brokerageFirmDocuments": {
"brokerageFirmDocumentsList": [
{
"category": "<string>",
"required": true,
"allowMultiple": true,
"extractionFields": [
{
"key": "<string>",
"type": "<string>",
"sides": [
"<string>"
]
}
],
"validity": [
{
"promptSlug": "<string>",
"requiredFields": [
"<array>"
],
"validations": [
{
"fieldKey": "<string>",
"reference": {
"fieldKey": "<string>",
"value": "<string>"
},
"duration": {
"amount": 123
},
"pattern": "<string>",
"expectedValue": "<string>",
"numericValue": 123,
"numericMin": 123,
"numericMax": 123,
"errorMessage": "<string>"
}
]
}
]
}
],
"signatureDocumentsList": [
{
"category": "<string>",
"required": true,
"allowMultiple": true,
"extractionFields": [
{
"key": "<string>",
"type": "<string>",
"sides": [
"<string>"
]
}
],
"validity": [
{
"promptSlug": "<string>",
"requiredFields": [
"<array>"
],
"validations": [
{
"fieldKey": "<string>",
"reference": {
"fieldKey": "<string>",
"value": "<string>"
},
"duration": {
"amount": 123
},
"pattern": "<string>",
"expectedValue": "<string>",
"numericValue": 123,
"numericMin": 123,
"numericMax": 123,
"errorMessage": "<string>"
}
]
}
]
}
]
},
"documentPrefill": {},
"reports": [
{
"type": "<string>",
"columnsMapping": [
{}
],
"availableProductIds": [
"<string>"
],
"allowedBusinessRoles": [
"<string>"
],
"automations": [
{}
]
}
],
"metabaseDashboardIds": [
{
"name": "<string>",
"dashboardId": 123,
"forTypes": [
"<string>"
],
"params": {}
}
],
"ai": {
"classification": {
"enabled": true,
"interfaces": {
"policyholderDashboard": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
},
"brokerageFirmDocuments": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
},
"nonDelegatedDocuments": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
},
"fnolDocuments": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
}
}
},
"extraction": {
"enabled": true,
"promptSlug": "<string>"
},
"validity": {
"enabled": true
},
"autofill": {
"enabled": true
},
"claimDocClassifier": {
"enabled": true,
"classificationPromptSlug": "<string>",
"claimDocCodeToCategory": {}
},
"claimDocExtractor": {
"enabled": true,
"promptSlug": "<string>"
},
"conversationSystemPrompt": "<string>"
},
"externalScripts": [
{
"id": "<string>",
"src": "<string>",
"async": true,
"defer": true,
"dataAttributes": {
"domain": "marsh-carrefour-banque-assurances.com?ID_SITE_MB=31",
"key": "pk_live_xxx",
"consent": "required"
},
"requiresInitToken": true
}
]
}{
"code": "INVALID_TENANT",
"message": "Invalid tenant {tenant}",
"details": {}
}config
Get a tenant's public config by domain
Matches a bare domain (no scheme, path or port) case-insensitively. Only domains explicitly registered against a tenant resolve, which is a small set used by white-label frontends — any other domain returns INVALID_TENANT, including one that looks like a Korint hostname.
GET
/
config
/
by-domain
Get a tenant's public config by domain
curl --request GET \
--url https://api.korint.io/config/by-domain \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.korint.io/config/by-domain"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.korint.io/config/by-domain', 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.korint.io/config/by-domain",
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.korint.io/config/by-domain"
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.korint.io/config/by-domain")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.korint.io/config/by-domain")
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{
"brokerageFirmCustomFields": [
{
"key": "<string>",
"validationRules": [
{
"option": "<string>",
"value": "<string>"
}
],
"integrationKey": "<string>",
"extractionSources": [
"<string>"
],
"extractionFieldKey": "<string>",
"autoFill": {
"enabled": true
}
}
],
"theme": {
"primaryColor": "#00387B",
"logo": "<string>",
"favicon": "<string>",
"logoDark": "<string>",
"secondaryColors": {
"cyan": "#00AEEF",
"red": "#BB1E10"
}
},
"authentication": {
"cognitoUserPoolId": "<string>",
"cognitoUserPoolClientId": "<string>",
"cognitoDomain": "<string>"
},
"tenantName": "<string>",
"availableProductIds": [
"<string>"
],
"tenantId": "<string>",
"speechToText": {},
"externalLinks": [
{
"label": "<string>",
"url": "<string>",
"id": "<string>"
}
],
"previousClaimsPlatformUrl": "<string>",
"displayName": "<string>",
"distributionRequest": {
"approveOnSignature": true,
"contractConfig": {
"templateId": "<string>",
"signature": {
"type": "<string>",
"configName": "<string>",
"signers": [
{
"role": "<string>",
"anchor": {
"page": {},
"x": 123,
"y": 123,
"height": 123,
"width": 123
},
"mentions": [
{
"page": {},
"x": 123,
"y": 123,
"mention": "<string>",
"width": 123
}
],
"texts": [
{
"page": {},
"x": 123,
"y": 123,
"width": 123,
"maxLength": 123,
"question": "<string>",
"height": 123,
"instruction": "<string>",
"optional": true
}
],
"checkboxes": [
{
"page": {},
"x": 123,
"y": 123,
"size": 123,
"name": "<string>",
"optional": true,
"checked": true
}
]
}
],
"anchor": {
"page": {},
"x": 123,
"y": 123,
"height": 123,
"width": 123
},
"mentions": [
{
"page": {},
"x": 123,
"y": 123,
"mention": "<string>",
"width": 123
}
],
"texts": [
{
"page": {},
"x": 123,
"y": 123,
"width": 123,
"maxLength": 123,
"question": "<string>",
"height": 123,
"instruction": "<string>",
"optional": true
}
],
"checkboxes": [
{
"page": {},
"x": 123,
"y": 123,
"size": 123,
"name": "<string>",
"optional": true,
"checked": true
}
]
}
}
},
"brokerageFirmDocuments": {
"brokerageFirmDocumentsList": [
{
"category": "<string>",
"required": true,
"allowMultiple": true,
"extractionFields": [
{
"key": "<string>",
"type": "<string>",
"sides": [
"<string>"
]
}
],
"validity": [
{
"promptSlug": "<string>",
"requiredFields": [
"<array>"
],
"validations": [
{
"fieldKey": "<string>",
"reference": {
"fieldKey": "<string>",
"value": "<string>"
},
"duration": {
"amount": 123
},
"pattern": "<string>",
"expectedValue": "<string>",
"numericValue": 123,
"numericMin": 123,
"numericMax": 123,
"errorMessage": "<string>"
}
]
}
]
}
],
"signatureDocumentsList": [
{
"category": "<string>",
"required": true,
"allowMultiple": true,
"extractionFields": [
{
"key": "<string>",
"type": "<string>",
"sides": [
"<string>"
]
}
],
"validity": [
{
"promptSlug": "<string>",
"requiredFields": [
"<array>"
],
"validations": [
{
"fieldKey": "<string>",
"reference": {
"fieldKey": "<string>",
"value": "<string>"
},
"duration": {
"amount": 123
},
"pattern": "<string>",
"expectedValue": "<string>",
"numericValue": 123,
"numericMin": 123,
"numericMax": 123,
"errorMessage": "<string>"
}
]
}
]
}
]
},
"documentPrefill": {},
"reports": [
{
"type": "<string>",
"columnsMapping": [
{}
],
"availableProductIds": [
"<string>"
],
"allowedBusinessRoles": [
"<string>"
],
"automations": [
{}
]
}
],
"metabaseDashboardIds": [
{
"name": "<string>",
"dashboardId": 123,
"forTypes": [
"<string>"
],
"params": {}
}
],
"ai": {
"classification": {
"enabled": true,
"interfaces": {
"policyholderDashboard": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
},
"brokerageFirmDocuments": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
},
"nonDelegatedDocuments": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
},
"fnolDocuments": {
"enabled": true,
"systemPromptSlug": "<string>",
"judgePromptSlug": "<string>",
"judges": [
{
"model": "<string>",
"enabled": true
}
]
}
}
},
"extraction": {
"enabled": true,
"promptSlug": "<string>"
},
"validity": {
"enabled": true
},
"autofill": {
"enabled": true
},
"claimDocClassifier": {
"enabled": true,
"classificationPromptSlug": "<string>",
"claimDocCodeToCategory": {}
},
"claimDocExtractor": {
"enabled": true,
"promptSlug": "<string>"
},
"conversationSystemPrompt": "<string>"
},
"externalScripts": [
{
"id": "<string>",
"src": "<string>",
"async": true,
"defer": true,
"dataAttributes": {
"domain": "marsh-carrefour-banque-assurances.com?ID_SITE_MB=31",
"key": "pk_live_xxx",
"consent": "required"
},
"requiresInitToken": true
}
]
}{
"code": "INVALID_TENANT",
"message": "Invalid tenant {tenant}",
"details": {}
}Authorizations
oauth2bearerAuth
Machine-to-machine clients use the OAuth 2.0 client credentials grant. Each tenant has its own authorization server: in the token URL below, replace tenant with your tenant identifier.
Query Parameters
Hostname the tenant frontend is being served on
Response
Show child attributes
Show child attributes
Visual theming configuration (colors, logos, branding)
Show child attributes
Show child attributes
Authentication configuration (Cognito user pool, OAuth domain)
Show child attributes
Show child attributes
Product ids active (feature-flag-enabled) for this tenant in this environment.
Resolved tenant ID for the requested domain
Speech-to-text (dictation) config. When set, dictation is enabled for this tenant; when absent, dictation is off. Exposed in the public tenant config so the frontend can gate the mic.
Show child attributes
Show child attributes
External links (attestations, notices, legal pages, …) rendered in the tenant frontend on the login page, the home page and the sidebar. Exposed in the public tenant config.
Show child attributes
Show child attributes
URL of the legacy claims platform. When set, the tenant frontend surfaces an alert pointing users to it for claims filed before migration. Exposed in the public tenant config.
Human-readable tenant name shown to end users in the tenant frontend. Falls back to the technical tenant ID when unset.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Controls the default choice (upload now vs. later) on the document prefill funnel step
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Metabase dashboard tabs configuration (takes priority over metabaseDashboardId)
Show child attributes
Show child attributes
Tenant-level AI configuration (classification, extraction)
Show child attributes
Show child attributes
Third-party scripts to inject into the tenant frontend at runtime (e.g. chat widgets). Each entry is rendered as a
Show child attributes
Show child attributes
Was this page helpful?
⌘I