List File Match Jobs
list_file_match_jobsList async file-based identity resolution jobs for the org. Each job corresponds to a matched segment created via create_segment(subtype=matched). Returns match_id, name, status, matching_status, input_record_count, match_count, match_rate, file_format, compression, segment_id, audience_id, audience_status, created_at, expires_at. Matching capacity consumption is reported after the first successful delivery. Its monetary estimate is denominated in USD and covers the matching component separately from delivery. audience_status (active/archived/null) reports whether the linked audience is still open-able in Library — job history itself always persists, even after the segment or audience is deleted. Cursor-paginated. Filter by status to find pending/active/failed jobs. Requires 'discovery' scope.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_file_match_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum jobs to return (default 30, max 100) | |
| before | No | Legacy ISO timestamp cursor for pagination | |
| cursor | No | Opaque next_cursor from the preceding page; mutually exclusive with before | |
| status | No | Filter by job status |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | ||
| guidance | No | Interpretation or recovery guidance for this result | |
| has_more | Yes | ||
| count_unit | No | ||
| page_count | No | Number of objects on this page, not the organization total | |
| count_state | No | Unknown means no count; available does not guarantee freshness. Recount for a current value. | |
| next_cursor | No | ||
| next_actions | No | Suggested next calls using returned IDs and available scopes. Not executed and not user consent. | |
| population_input | No | Population input used for the preview; IDs refer to their current saved definitions |