> For the complete documentation index, see [llms.txt](https://help.screena.ai/resources/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.screena.ai/resources/faq/name-matching/how-does-secondary-attributes-matching-work.md).

# How does secondary attributes-matching work?

Matching named entities requires algorithms to determine how data should be matched. In this regard, we distinguish [**name-matching algorithms**](https://developer.screena.ai/#name-matching-algorithms) from **secondary attributes-matching algorithms**.

Matching names requires a **threshold value** between 0 and 100%. This value helps to determine the point where it becomes highly probable that two names are the same.

In addition to name matching, it is also possible to apply specific [**matching algorithms**](https://developer.screena.ai/#algorithms) to secondary attributes (e.g., date of birth, address, nationality). Using secondary attributes-matching algorithms helps to automatically discard irrelevant matches (i.e., false positives) by leveraging more data points than names alone.

{% hint style="info" %}
You can check [Screena Plus endpoints](https://developer.screena.ai/#screena-plus) to find out all secondary attributes available per type of entity (i.e., individuals, organizations, vessels).
{% endhint %}

Here is a code example of how to search an individual with date of birth as a secondary attribute.

This request uses the [date-matching algorithm](https://developer.screena.ai/#date-matching-algorithms) `dateOfBirthAlgo` to match dates of birth within the same year:

{% code lineNumbers="true" %}

```json
{
	"queries": [{
		"sourceData": [{
			"names": [{
				"fullName": "Adan Antonio Blanco Rodriguez"
			}],
			"datesOfBirth": [{
				"date": "1968-03-18"
			}]
		}],
		"targetData": [{
			"datasets": [{
				"label": "USA"
			}]
		}],
		"threshold": 0.8,
		"dateOfBirthAlgo": {
			"type": "same_year"
		}
	}]
}
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.screena.ai/resources/faq/name-matching/how-does-secondary-attributes-matching-work.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.