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

# Get File Matches

Get sensitive file details including the list of matched content occurrences.

<Note>
  External Documentation

  To learn more, visit the [Egnyte Secure Govern documentation](https://developers.egnyteprotect.com/#tag/sc/operation/scGetFileMatches).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter            | Description                                                                                                                                                                     |
  | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | File ID              | ID of the file, as listed by the source.                                                                                                                                        |
  | Include Text Context | Number of characters before and after the match to include in the context. Context is only returned if this parameter is set. Otherwise context field is missing from response. |
  | Source ID            | ID of the source.                                                                                                                                                               |
</div>

## Example Output

```json theme={"dark"}
{
	"id": "ID of the file, as listed by the source",
	"lastUpdated": 0,
	"latestVersionId": "from latestEntryId or from versionId in CLFS sources",
	"locationId": "uuid",
	"matches": [
		{
			"pattern": "ID of the pattern that matched content, various formats possible",
			"patternName": "Human readable name for the pattern matched",
			"position": {
				"cellRange": "Cell range in Excel file the matches were found in. Example: C3:C10",
				"context": {
					"after": "Content after the match",
					"before": "Content before the match"
				},
				"matchingFragments": [
					"string"
				],
				"page": 0,
				"sheet": "Sheet name in Excel file the matches were found in. Example: Summary"
			},
			"sample": "Sample text that occurred and matched a pattern. It can be the single matched string or an example one of multiple matches.",
			"type": "What kind of a match is this - sensitive content found in text or the entire document is of sensitive type (eg. an invoice), or metadata of the document matches (author field in a .docx etc.)"
		}
	],
	"name": "FROM: filename in Secure and Govern",
	"path": "example: /Shared/Documents/GoldenDataset longNames/Bank info",
	"policies": [
		"ID of the policy (not tag)"
	],
	"risk": 0,
	"sourceId": "TODO: seems redundant",
	"url": "string"
}
```

## Workflow Library Example

[Get File Matches with Egnyte Secure Govern and Send Results Via Email](https://library.blinkops.com/workflows/get-file-matches-with-egnyte-secure-govern-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/get-file-matches-with-egnyte-secure-govern-and-send-results-via-email/canvas" />
</div>