> ## Documentation Index
> Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetching Matches

Once you have created one or more External Companies and
[linked Vacancies or desired functions](/tutorials/companies/linking-vacancies/)
to it, you can start generating Company/Employee matches! The matching score
between a given External Company and Employee is defined as the highest match
score this Employee has with one of the Vacancies linked to the External
Company.

## Finding External Companies for an Employee

To find the most suitable External Companies for a given Employee, you can
request the best matches through a `GET` request to
`employees/<external_id>/matching_companies/`. As is the case in
[matching between Employees and Vacancies](/tutorials/vacancy-matching/fetching-matches/)
, you can use the `limit`, `max_geo_distance` and `score_min_threshold` query
parameters to further filter results.

## Finding Employees for an External Company

Finding the most suitable Employees for a given External Company is similar to
the approach described above, with the only difference being the endpoint:
`companies/<external_id>/matching_employees/`. You can use the same query
parameters for filtering.

## Explainability

The score calculation between an External Company and Employee is reflected
transparently through the API response, which returns the Vacancy `external_id`
and `job_title` for each Vacancy that contributed to the match result. This
explanation is found in the `matching_vacancies` field in each item in the
response. To dive a bit deeper into the match still, you can use the explained
Employee/Vacancy matching.