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

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

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

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

key

additional properties

any

Examples

missing_scope

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