Enrichment

Get a file match job

Get a single file match job by segment ID. Returns 404 if the segment does not exist or is not a matched-subtype segment. Requires 'discovery' scope.

get/v1/match/file/{matchId}

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/match/file/{matchId}
  • Auth: HTTP bearer

Path parameters

matchIdstring required

Headers

X-Integration-Run-Idstring

Required for an OAuth partnership to access a private file job; the run must belong to the same active OAuth grant.

Response

File match job details

match_idstring required
namestring required
status'pending' | 'active' | 'failed' | 'archived' | 'expired' required
matching_status'pending' | 'processing' | 'completed' | 'failed' | 'null' nullable required
input_record_countinteger nullable required
match_countinteger nullable required
match_ratenumber float nullable required
amount_chargednumber nullable required

One-time file-match USD estimate accepted when this run first participates in a successful delivery. Null before first delivery; excludes the delivery's separate audience/destination/field usage and is not a finalized invoice amount.

file_format'csv' | 'avro' | 'json' | 'jsonl' | 'null' nullable required
compression'none' | 'gzip' required

Input artifact compression, normalized to none for legacy jobs.

column_mappingsobject nullable
error_messagestring nullable
segment_idstring required
audience_idstring nullable required
audience_status'active' | 'archived' | 'null' nullable required

Whether the linked audience (if any) is still active in Library. archived covers both an explicitly archived audience and a deleted one. null when there's no audience_id, or its audience document no longer exists. This job's own history is unaffected either way — it persists even after the underlying segment or audience is deleted from Library.

source_job_idstring nullable required
integration_run_idstring

Present only for an authorized private partnership workflow.

created_atstring date-time nullable required
expires_atstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.