---
title: "Lookup items by URN"
method: POST
path: "/search/lookup/bulk"
tags: ["search"]
---

# Lookup items by URN

`POST /search/lookup/bulk`

Resolve many indexed items in one request using a batch of URNs.

Use this for:
- import previews
- server-side enrichment jobs
- list views that need to hydrate many URNs quickly

Behavior:
- Accepts between 1 and 200 URNs per request.
- Returns found indexed item records for matching URNs.

Good to know:
- URNs are normalized into a stable cache signature, so repeated batches are efficient.

## Request body

- object
  - `urns` string[], required — List of URNs to lookup. Maximum of 200 items to match search limits

## Response `200`

List of found items and unprocessed URNs

- union[] — Items found for the provided URNs
  - union
    - object
      - `urn` string, required
      - `type` 'card', required
      - `game` 'Pokemon', required
      - `title` string, required
      - `name` string, required
      - `rarity` string, required
      - `number` string, nullable
      - `description` string
      - `set` object, required
        - `name` string, required
        - `size` number
        - `urn` string, required
        - `counts` object, required
          - `printed` number
          - `total` number
        - `symbol` object
          - `url` string, required
        - `released` string
        - `references` string[], required
      - `series` object, required
        - `name` string, required
        - `urn` string, required
      - `images` object[], required
        - `urn` string, required
        - `illustrator` string
        - `orientation` 'portrait' | 'landscape', required
        - `url` string, uri, required
      - `alternatives` string[], required
      - `metadata` object[], required
        - `name` string, required
        - `value` union
          - string
          - string[]
          - number
          - number[]
        - `detail` union
          - unknown
          - unknown[]
            - unknown
      - `price` integer
      - `available` integer — Total available for this listing
      - `quantity` integer — Total quantity available
      - `min` object
        - `price` integer, nullable, required — Price of the cheapest listing in pence
      - `max` object
        - `price` integer, nullable, required — Price of the most expensive listing in pence
    - object
      - `urn` string, required
      - `type` 'product', required
      - `game` 'Pokemon', required
      - `title` string, required
      - `name` string, required
      - `classification` 'CARD', required
      - `count` number, required
      - `description` string
      - `images` object[], required
        - `urn` string, required
        - `illustrator` string
        - `orientation` 'portrait' | 'landscape', required
        - `url` string, uri, required
      - `series` object, required
        - `name` string, required
        - `urn` string, required
      - `set` object, required
        - `name` string, required
        - `size` number
        - `urn` string, required
        - `counts` object, required
          - `printed` number
          - `total` number
        - `symbol` object
          - `url` string, required
        - `released` string
        - `references` string[], required
      - `metadata` object[], required
        - `name` string, required
        - `value` union
          - string
          - string[]
          - number
          - number[]
        - `detail` union
          - unknown
          - unknown[]
            - unknown
      - `price` integer
      - `available` integer — Total available for this listing
      - `quantity` integer — Total quantity available
      - `min` object
        - `price` integer, nullable, required — Price of the cheapest listing in pence
      - `max` object
        - `price` integer, nullable, required — Price of the most expensive listing in pence

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/6367b514f6ea/schema)