List file match jobs
const url = 'https://api.infiniteaudience.ai/v1/match/file?limit=30&status=pending';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.infiniteaudience.ai/v1/match/file?limit=30&status=pending' \ --header 'Authorization: Bearer <token>'List file match jobs for the org, newest first. Cursor-paginated. Optional status filter. Job history persists even after the underlying segment or its linked audience is deleted from Library — deleted jobs are not excluded from this list.
Requires ‘discovery’ scope.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Opaque next_cursor from the previous response. Keep filters unchanged. Mutually exclusive with legacy before.
Exclusive upper bound cursor on created_at (ISO 8601)
Filter by segment status
Responses
Section titled “Responses”Paginated list of file match jobs
object
A file-based match job (matched-subtype segment)
object
Delivered IAG refresh version. Independent of license status. Null provenance means unknown; a newer refresh-major can prompt a refresh through existing workflows. Active licenses and existing identity IDs support free refresh; normal charges may apply otherwise.
object
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.
Input artifact compression, normalized to none for legacy jobs.
Warnings about how the uploaded file’s columns are used. analysis entries are the automatic column analysis’s warnings on low-confidence mappings (below 0.6) that feed matching, and appear only when that analysis produced column_mappings. A nested_addresses entry is recomputed on every matching run, whoever supplied the mappings, when the addresses column has unrecognized keys or is not an array of address objects (it is then ignored). null before the first run’s analysis step. Returned by the single-job lookup only.
object
The uploaded file’s column the warning is about.
analysis is the automatic column analysis’s warning on a low-confidence mapping; nested_addresses is the platform’s check of the addresses column.
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.
Present only for an authorized private partnership workflow.
Pass as cursor for the next page; null at the end.
Example
{ "jobs": [ { "status": "pending", "matching_status": "pending", "file_format": "csv", "compression": "none", "mapping_warnings": [ { "code": "analysis" } ], "audience_status": "active" } ]}Invalid request — malformed body, missing required attribute, or failed validation. See error and message for details.
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Examples
{ "error": "Bad Request", "code": "MISSING_SEGMENTS", "message": "segment_ids is required for filter audiences."}Missing or invalid Bearer token. Obtain one via POST /v1/auth/token. When a token was supplied but rejected, code distinguishes TOKEN_EXPIRED (the token’s lifetime has passed — request a new one via POST /v1/auth/token and retry) from TOKEN_INVALID (malformed or revoked — re-authenticate).
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Examples
{ "error": "Unauthorized: Missing or invalid Authorization header"}{ "error": "Unauthorized", "code": "TOKEN_EXPIRED", "message": "Your session has expired. Please sign in again."}Token is valid but lacks the required scope for this endpoint. Check the endpoint description for the required scope (discovery, purchase, or account).
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Examples
{ "error": "SCOPE_REQUIRED", "message": "This endpoint requires the creator scope."}