Attribute catalog with pricing

GET

/v1/catalog/fields

const url = 'https://dev-api.infiniteaudience.ai/v1/catalog/fields';
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://dev-api.infiniteaudience.ai/v1/catalog/fields \
  --header 'Authorization: Bearer <token>'

Returns the list of available enrichment attributes — every attribute with product_usage containing audience (the definition of a valid user-facing IAG attribute) — with coverage rates and per-attribute pricing, plus the single system delivery template. Use this to browse available attributes before creating a delivery. Requires ‘discovery’ scope.

Authorizations

bearerAuth

Responses

200

Attribute catalog.

application/json

object

fields

Available enrichment attributes from the column registry.

Array<object>

object

field_name

Programmatic attribute name to use in field_list.

string

label

Human-readable display label.

string

data_type

BigQuery data type (e.g. STRING, INT64, FLOAT64).

string

coverage_rate

Fraction of records that have a value for this attribute (0.0–1.0).

number

templates

Always exactly one entry — the Standard IAG template, usable as a template_id shortcut. Its fields is the full audience attribute set above, resolved live from the registry (not a hardcoded list).

Array<object>

object

template_id

ID to pass as template_id in delivery or quote requests.

string

Allowed values: standard_iag

label

Human-readable template name.

string

fields

Attribute names included in this template.

Array<string>

pricing

Effective per-record pricing for the calling org.

object

base_record_price

required

Base cost per record (USD).

number

matched_record_price

required

Cost per resolved record for matched audiences (USD).

number

micro_batch_price_per_record

required

Cost per resolved record for synchronous micro-batch matching (USD).

number

field_surcharges

required

Additional per-record cost for specific attributes (field_name → USD).

object

key

additional properties

number

delivery_surcharges

required

Per-record surcharge by destination (destination → USD).

object

key

additional properties

number

usage_discount_bps

required

Contract usage-rate discount in basis points; commitment charges and minimums are unchanged.

integer

<= 10000

projected_at

required

string | null format: date-time

Example

{
  "templates": [
    {
      "template_id": "standard_iag",
      "label": "Standard IAG",
      "fields": [
        "age",
        "gender",
        "estimated_household_income"
      ]
    }
  ]
}

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."
}