Deliveries

Get a single delivery

Returns status, cost, download URL (if completed), and full metadata for a single delivery. Poll this endpoint after calling POST /v1/audiences/{id}/deliveries to track progress.

Note on download_urls: for completed download deliveries, the server regenerates fresh 24-hour presigned URLs on every GET. This means repeated calls return different URLs — all pointing to the same file(s). Always use the download_urls from the most recent response. Requires 'discovery' scope.

get/v1/audiences/{id}/deliveries/{delivery_id}

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/audiences/{id}/deliveries/{delivery_id}
  • Auth: HTTP bearer

Path parameters

idstring required

Audience document ID.

delivery_idstring required

Delivery document ID.

Response

Delivery details.

delivery_idstring required
audience_idstring required
audience_versioninteger required
destination'download' | 'liveramp' | 'narrative' required
template_idstring nullable
field_liststring[] nullable
status'processing' | 'completed' | 'failed' required
costnumber required

Conservative USD estimate for usage accepted for billing; not a finalized invoice total.

estimated_costnumber

Pre-flight safety ceiling for a still-processing delivery. It is released into the final local cost estimate once resolution/export completes; the finalized invoice remains authoritative.

already_deliveredboolean

true when this exact audience content, resolved field selection, unmatched-row policy, and destination were already delivered — cost is 0 and the existing delivery record is returned.

messagestring

Human-readable note, present on free re-delivery responses.

created_atstring required
completed_atstring nullable
expires_atstring required
output_format'csv' | 'avro' | 'json' | 'jsonl'

Output file format. Present on download deliveries. Avro exports preserve native source column types (including REPEATED/array columns) rather than flattening everything to strings. Read endpoints normalize legacy records; an immediate DSP-create response may omit this field.

output_compression'none' | 'gzip'

Explicit outer artifact compression, normalized to none for legacy records on read and possibly omitted by an immediate DSP-create response. It never inherits input compression. Avro uses native DEFLATE and therefore reports none here rather than outer gzip.

output_bytesinteger nullable

Exact sum of stored object sizes across every output part. Null until completion or when no downloadable artifact is produced.

download_urlsstring[] nullable

Signed download URLs for every completed download artifact part, sorted deterministically. Always an array and may contain multiple export parts for any format. Signed URLs expire after 24 hours — call GET /v1/audiences/{id}/deliveries/{did} to regenerate fresh URLs at any time.

output_record_countinteger nullable

Actual row count in the exported file. Set at completion for matched audiences only (where the count is unknown until the TVF runs). For filter, similarity, and propensity audiences this equals the audience's record_count.

failure_reasonstring nullable
matched_segment_idstring nullable

ID of the matched (file-match) segment resolved from the delivered audience's composition at delivery creation. Populated only when the audience includes a matched segment; null for filter, similarity, and propensity deliveries and for deliveries created before this attribute existed.

source_job_idstring nullable

The matched segment's originating file-match job ID — links the delivery back to the file-match event that produced its source data. Populated only when the delivered audience resolves a matched segment that carries a source job; null otherwise (including deliveries created before this attribute existed).

integration_run_idstring

Present only for an authorized private partnership workflow.

Changes

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