---
title: "UCP catalog lookup"
method: POST
path: "/ucp/catalog/lookup"
tags: ["UCP"]
---

# UCP catalog lookup

`POST /ucp/catalog/lookup`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/ucp/catalog/lookup`
- Auth: none declared

Universal Commerce Protocol `dev.ucp.shopping.catalog.lookup`. Returns products in the order the ids were given; ids that no longer exist are reported in `messages` and the rest are still returned.

## Request body

- LookupRequest
  - `context` Context
    - `address_country` string, nullable
    - `address_region` string, nullable
    - `postal_code` string, nullable
    - `intent` string, nullable
    - `language` string, nullable
    - `currency` string, nullable
    - `eligibility` string[], nullable
  - `signals` object, nullable
  - `attribution` object, nullable
  - `filters` SearchFilters
    - `categories` string[], nullable
    - `price` PriceFilter
      - `min` integer, nullable
      - `max` integer, nullable
  - `ids` string[], required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/rubenayla/apis/partle-api.md) · [All operations](https://skmtc.dev/rubenayla/apis/partle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rubenayla/apis/partle-api/revisions/628cce2acee5?raw)