---
title: "Get Match Booster configuration"
method: GET
path: "/models/{modelId}/match-booster"
---

# Get Match Booster configuration

`GET /models/{modelId}/match-booster`

## Request

- Base URL: `https://api.hightouch.com/api/v1`
- URL: `https://api.hightouch.com/api/v1/models/{modelId}/match-booster`
- Auth: HTTP bearer

Get a model's Match Booster configuration. For audience models the
configuration is resolved from the parent model.

## Path parameters

- `modelId` number, double, required

## Response `200`

Ok

- union
  - MatchBoosterConfig: A model's Match Booster configuration.
    - `enabled` boolean, required: Whether Match Booster enrichment is enabled for the model.
    - `settingsModelId` number, double, required: The model that carries the Match Booster settings. For audience models this is the parent model; configuration changes must target it directly.
    - `regions` MatchBoosterRegionConfig[], required
      - `region` 'us' | 'eu', required: The Match Booster region this configuration applies to.
      - `householdExpansion` boolean: Expand targeting to people and devices sharing the same residential address. Not available in the EU region.
      - `ctvMatching` boolean: Match person and household records to third-party IP addresses and CTV IDs. Not available in the EU region.
      - `enrichmentSchedule` MatchBoosterEnrichmentSchedule: How often enrichment runs. The total interval may not exceed 28 days.
        - `interval` MatchBoosterEnrichmentInterval, required
          - `unit` 'hour' | 'day' | 'week', required
          - `quantity` integer, required
    - `columnMappings` MatchBoosterColumnMapping[], required
      - `column` string, required: The name of the model column.
      - `idType` string, required: The Match Booster identifier type for the column, e.g. "email", "phone", "email_sha256". Validated against the supported identifier types at request time.
  - ValidateErrorJSON
    - `message` 'Validation failed', required
    - `details` object, required
  - 'Internal Server Error'

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Something went wrong

## Changes

- **2026-11-04** `7f9793951e4f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hightouch/apis/hightouch-api/changes/models/:modelId/match-booster/get.md)

---

[API](https://skmtc.dev/hightouch/apis/hightouch-api.md) - [All operations](https://skmtc.dev/hightouch/apis/hightouch-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hightouch/apis/hightouch-api/revisions/7f9793951e4f?raw)