Get specific Autopilot match statistic
Learn how to retrieve a specific Autopilot match statistic record using its composite key.
The Get Autopilot match statistic API retrieves a single Autopilot match statistic record for a tenant. It identifies the record using a composite key that includes the lookupType, source, and unmappedValue.
You can use this API to inspect detailed matching information for a specific value, including scoring metrics, mapping status, and system-generated insights.
HTTP method and endpoint
Use the following HTTP method and endpoint path to submit the request:
GET /configuration/{tenantId}/autopilot/stats/{lookupType}/{source}/{unmappedValue}
This endpoint retrieves a specific Autopilot match statistic record based on the provided composite key.
The following table describes the endpoint path parameters.
| Parameter | Type | Required | Description |
|---|---|---|---|
tenantId | String | Yes | Tenant identifier. |
lookupType | String | Yes | Lookup type name for example Country . |
source | String | Yes | Source system name. |
unmappedValue | String | Yes | Unmapped value. This value can contain / characters. |
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 |
|---|---|---|
tenantId | String | The identifier of the tenant. |
lookupType | String | The lookup type associated with the match. |
source | String | The source system that provided the value. |
unmappedValue | String | The original value that was not mapped. |
candidateLookupCode | String | The lookup code suggested as a match. |
candidateValue | String | The suggested lookup value. |
semanticScore | Number | Semantic similarity score. |
aiConfidence | Number | Confidence score from AI evaluation. |
centroidMatch | Boolean | Indicates whether centroid-based matching was applied. |
currentFrequency | Integer | Current occurrence count of the value. |
requiredFrequency | Integer | Required frequency for mapping. |
frequencyAtMapping | Integer | Frequency at the time of mapping. |
frequencyWindowHours | Integer | Frequency evaluation window in hours. |
status | String | Current match status. |
mappedAt | Number | Timestamp when the value was mapped. |
mappedBy | String | Identifier of the user or system that performed the mapping. |
aiReasoning | String | Explanation generated for the match decision. |
createdAt | Number | Timestamp when the record was created. |
configVersion | Integer | Autopilot configuration version used. |
updateDate | Number | Last update timestamp in epoch milliseconds. |
Example response
The following example shows a response containing a match statistic record.
{
"tenantId": "my_tenant",
"lookupType": "Country",
"source": "CRM_SYSTEM",
"unmappedValue": "United Staets",
"candidateLookupCode": "US",
"candidateValue": "United States",
"semanticScore": 0.92,
"aiConfidence": 0.95,
"centroidMatch": true,
"currentFrequency": 12,
"requiredFrequency": 3,
"frequencyAtMapping": 5,
"frequencyWindowHours": 24,
"status": "AUTOMAPPED",
"mappedAt": 1704200000000,
"mappedBy": "SYSTEM",
"aiReasoning": "Likely typo - 'United Staets' closely matches 'United States' with transposed letters",
"createdAt": 1704067200000,
"configVersion": 3,
"updateDate": 1704200000000
}