---
title: "Enrich a product catalog"
method: POST
path: "/enrich"
---

# Enrich a product catalog

`POST /enrich`

## Request

- Base URL: `https://tetheredtrust.com/v1`
- URL: `https://tetheredtrust.com/v1/enrich`
- Auth: one of:
  - none
  - HTTP bearer

For retailers and marketplaces (API key required): up to 50 products per call (SKU with title, URL or GTIN) in; each product's compatibility attributes out (standards it takes and provides, numeric limits, evidence level, freshness), ready to add to a product feed or UCP catalog so agents can match it to what shoppers own.

## Request body

- object
  - `items` object[], required
    - `id` string: Your SKU or offer id (echoed back).
    - `title` string
    - `url` string
    - `gtin` string
    - `brand` string
    - `model` string
  - `research` boolean: Default true: research up to 10 items per call that aren't in our catalog (from the manufacturer's page).

## Response `200`

OK

- object

## Other responses

- `400`: Bad input (code bad_request), or plain HTTP (https_required).
- `401`: Missing or invalid API key where one is required.
- `402`: Payment required: pay with x402 or credits and retry. Verified first, settled only for a completed decision.
- `429`: Rate limit; see Retry-After.
- `500`: Our error; retry once.
- `503`: Temporarily unavailable, or paid access is off (paid_access_off).

---

[API](https://skmtc.dev/tetheredtrust/apis/tethered-trust-api.md) · [All operations](https://skmtc.dev/tetheredtrust/apis/tethered-trust-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tetheredtrust/apis/tethered-trust-api/revisions/f737ac591159?raw)