---
updatedAt: 2026-04-07T10:14:45.000Z
agentTools:
  siteIndex: https://developers.liveramp.com/llms.txt
  projectIndex: https://developers.liveramp.com/abilitec-api/llms.txt
---

# matchMetadata Bundle

For calls to the [Match Endpoint](https://developers.liveramp.com/abilitec-api/reference/match-endpoint), the `matchMetadata` bundle returns information about the components used to obtain the match.

The following table provides information on the metadata elements returned.

[block:parameters]
{
  "data": {
    "h-0": "Data Element",
    "h-1": "Type",
    "h-2": "Description",
    "h-3": "Example or Valid Values",
    "0-0": "matchComponents",
    "0-1": "array of strings",
    "0-2": "Components that contributed to the match.",
    "0-3": "name|streetAddress|zipCode|businessName|phoneNumber|emailAddress",
    "1-0": "distinctMatch",
    "1-1": "boolean",
    "1-2": "When distinctMatch equals true, this flag indicates that a single highest score match was found. Note: The distinct match flag for person and place documents is equal to true when there is only one distinct AbiliTec ID for a given match cascade step. For entity documents, the distinct match flag is equal to true when there is only one unique ConsumerLink for that entity.\\*\\*",
    "1-3": "true",
    "2-0": "matchConfidence",
    "2-1": "string",
    "2-2": "Indicates the confidence in the match. Corresponds directly to the step in which it matched in the cascade (see matchComponents)",
    "2-3": "",
    "3-0": "nameMatchIntegrity",
    "3-1": "string",
    "3-2": "Indicates whether part or all of the major name components were used to obtain the match",
    "3-3": "• partial  \n• complete"
  },
  "cols": 4,
  "rows": 4,
  "align": [
    "left",
    "left",
    "left",
    "left"
  ]
}
[/block]

\*\*The distinctMatch flag is only valid on requests where limit is not set, or limit=1.

## Example

Sample matchMetadata bundle in JSON format

```json
{
  "matchMetadata": {
      "matchComponents" : [ "name", "zipCode" ],
      "distinctMatch" : false,
      "matchConfidence" : "8",
      "nameMatchIntegrity" : "complete"
  }
}
```