List retained partnership activity

GET

/v1/integration-runs

const url = 'https://api.infiniteaudience.ai/v1/integration-runs?kind=batch_enrichment&status=created&limit=25';
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/integration-runs?kind=batch_enrichment&status=created&limit=25' \
  --header 'Authorization: Bearer <token>'

Returns safe aggregate summaries for batch/file partnership workflows. Raw workflow objects, identity manifests, row data, and signed URLs are never returned. Use at most one optional filter. Requires ‘discovery’ scope.

Authorizations

bearerAuth

Parameters

Query Parameters

provider

string

connection_id

string

kind

string

Allowed values: batch_enrichment file_enrichment ingest activation export

status

string

Allowed values: created processing awaiting_boundary settling completed failed cancelled

limit

integer

default: 25 >= 1 <= 100

cursor

string

Responses

200

Retained partnership activity

application/json

object

runs

required

Array<object>

object

data_release

required

One of:

object
null

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

major

required

integer

>= 1

minor

required

integer

run_id

required

string

provider

required

string

connection_id

required

string

connection_display_name

required

string | null

kind

required

string

Allowed values: batch_enrichment file_enrichment ingest activation export

data_flow

required

string

Allowed values: provider_to_platform platform_to_provider round_trip

purpose

required

string

Allowed values: enrichment ingest activation export

status

required

string

Allowed values: created processing awaiting_boundary settling completed failed cancelled

billing_source

required

string

Allowed values: native shopify

customer_boundary

required

string

Allowed values: api_response file_available destination_handoff provider_writeback

counts

required

object

input

required

integer

matched

required

integer

delivered

required

integer

applied

required

integer

unchanged

required

integer

skipped

required

integer

failed

required

integer

selected_fields

required

Array<string>

boundary_at

required

string | null format: date-time

failure_code

required

string | null

failure_message

required

string | null

created_at

required

string format: date-time

updated_at

required

string format: date-time

completed_at

required

string | null format: date-time

has_more

required

boolean

next_cursor

required

string | null

Example

{
  "runs": [
    {
      "kind": "batch_enrichment",
      "data_flow": "provider_to_platform",
      "purpose": "enrichment",
      "status": "created",
      "billing_source": "native",
      "customer_boundary": "api_response"
    }
  ]
}

400

Invalid request — malformed body, missing required attribute, or failed validation. See error and message for details.

application/json

object

error

required

Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.

string

message

Human-readable explanation of the error.

string

code

Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.

string

request_id

Opaque support/debug identifier when available.

string

next_step

Public action for correcting the request or retrying later.

string

issues

Array<object>

object

path

required

JSON path to the invalid filter field or value.

string

code

required

string

Allowed values: INVALID_FILTER_SHAPE UNKNOWN_FILTER_FIELD FIELD_NOT_FILTERABLE UNSUPPORTED_FILTER_OPERATOR UNSUPPORTED_TEXT_COMPARISON INVALID_FILTER_VALUE INVALID_ENUM_VALUE AMBIGUOUS_ENUM_VALUE

message

required

string

suggestions

Array<string>

key

additional properties

any

Examples

validation_error

{
  "error": "Bad Request",
  "code": "MISSING_SEGMENTS",
  "message": "segment_ids is required for filter audiences."
}

401

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).

application/json

object

error

required

Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.

string

message

Human-readable explanation of the error.

string

code

Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.

string

request_id

Opaque support/debug identifier when available.

string

next_step

Public action for correcting the request or retrying later.

string

issues

Array<object>

object

path

required

JSON path to the invalid filter field or value.

string

code

required

string

Allowed values: INVALID_FILTER_SHAPE UNKNOWN_FILTER_FIELD FIELD_NOT_FILTERABLE UNSUPPORTED_FILTER_OPERATOR UNSUPPORTED_TEXT_COMPARISON INVALID_FILTER_VALUE INVALID_ENUM_VALUE AMBIGUOUS_ENUM_VALUE

message

required

string

suggestions

Array<string>

key

additional properties

any

Examples

{
  "error": "Unauthorized: Missing or invalid Authorization header"
}

{
  "error": "Unauthorized",
  "code": "TOKEN_EXPIRED",
  "message": "Your session has expired. Please sign in again."
}

403

Token is valid but lacks the required scope for this endpoint. Check the endpoint description for the required scope (discovery, purchase, or account).

application/json

object

error

required

Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.

string

message

Human-readable explanation of the error.

string

code

Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.

string

request_id

Opaque support/debug identifier when available.

string

next_step

Public action for correcting the request or retrying later.

string

issues

Array<object>

object

path

required

JSON path to the invalid filter field or value.

string

code

required

string

Allowed values: INVALID_FILTER_SHAPE UNKNOWN_FILTER_FIELD FIELD_NOT_FILTERABLE UNSUPPORTED_FILTER_OPERATOR UNSUPPORTED_TEXT_COMPARISON INVALID_FILTER_VALUE INVALID_ENUM_VALUE AMBIGUOUS_ENUM_VALUE

message

required

string

suggestions

Array<string>

key

additional properties

any

Examples

missing_scope

{
  "error": "SCOPE_REQUIRED",
  "message": "This endpoint requires the creator scope."
}