Get Lookup type Configuration API
Learn how to retrieve configuration settings for a specific lookup type.
Use this API to retrieve the Autopilot configuration entry for a specific lookup type from the main Autopilot configuration. The response includes the lookup type URI and its configuration settings.
This API returns Autopilot settings for a lookup type only when explicit overrides have been defined for that lookup. If no lookup-specific configuration exists, the API returns an error instead of falling back to tenant defaults. This is a key difference from the Get effective Autopilot configuration for a lookup type, which provides the effective configuration by applying tenant defaults when overrides are not present.
HTTP method and endpoint
Use the following HTTP method and endpoint path to submit the request:
GET /configuration/{tenantId}/autopilot/{lookupType}
The following table describes the endpoint path parameters.
| Parameter | Type | Required | Description |
|---|---|---|---|
tenantId | String | Yes | Tenant identifier |
lookupType | String | Yes | Lookup type name |
Request headers
The following request headers must be included.
| Header | Value | Required |
|---|---|---|
Authorization | Bearer {token} | Yes |
Request body
This operation does not require a request body.
Response body
The following table describes the fields returned in the response body.
| Field | Type | Description |
|---|---|---|
uri | string | Lookup type URI. |
settings | object | Autopilot settings for the lookup type. |
enabled | boolean | Enables or disables Autopilot. |
mode | string | Operating mode for Autopilot. |
autoMapEnabled | boolean | Enables automatic mapping. |
autoMapThreshold | number | Confidence threshold for automatic mapping. |
suggestionEnabled | boolean | Enables suggestions for mapping |
suggestionThreshold | number | Confidence threshold for suggestions. |
createLookupEnabled | boolean | Enables automatic lookup creation. |
createLookupThreshold | number | Confidence threshold for lookup creation. |
suggestLookupEnabled | boolean | Enables lookup creation suggestions |
suggestLookupThreshold | number | Confidence threshold for lookup suggestions. |
misspelledThreshold | number | Threshold used for misspelling detection. |
requiredFrequency | integer | Minimum occurrence frequency required before applying certain actions. |
frequencyWindowHours | integer | Time window, in hours, used when evaluating frequency. |
Example response
The following example shows a response containing the lookup type configuration.
{
"uri": "rdm/lookupTypes/Country",
"settings": {
"enabled": true,
"mode": "ACTIVE",
"autoMapEnabled": true,
"autoMapThreshold": 0.70,
"suggestionEnabled": true,
"suggestionThreshold": 0.50,
"createLookupEnabled": false,
"createLookupThreshold": 0.90,
"suggestLookupEnabled": false,
"suggestLookupThreshold": 0.75,
"misspelledThreshold": 0.70,
"requiredFrequency": 5,
"frequencyWindowHours": 1
}
}