---
title: "Get merchant details"
method: GET
path: "/v1/merchants/{id}"
tags: ["Discovery"]
---

# Get merchant details

`GET /v1/merchants/{id}`

## Request

- Base URL: `https://api.insumermodel.com`
- URL: `https://api.insumermodel.com/v1/merchants/{id}`
- Auth: none required

Returns full public merchant profile including token tiers and NFT collections. 404 while the store's recognition is paused.

## Path parameters

- `id` string, required

## Response `200`

Merchant details

- object
  - `ok` true
  - `data` MerchantDetail
    - `id` string
    - `companyName` string
    - `website` string
    - `location` string
    - `verified` boolean
    - `verifiedDomain` string
    - `discountMode` 'highest' | 'stack' | 'capped': The merchant's stored discount mode, returned as configured.
    - `discountCap` integer
    - `tokens` object[]
    - `ownToken` object, nullable
    - `partnerTokens` object[]
    - `nftCollections` object[]
    - `acceptsUsdc` boolean
    - `walletTerms` WalletTerms: What this store gives a wallet with and without proof of control, so an agent can decide before calling whether to sign. A proven wallet gets the full discount its holdings earn (under the store's tiers and cap), without the daily limit for unproven wallets.
      - `proofAccepted` string[]: Wallet types whose proof is accepted. Currently ["evm"].
      - `proven` object
        - `maxDiscountsPerWalletPerDay` unknown
      - `unproven` object
        - `maxDiscount` integer, nullable: At most this percent without proof; 0 = no discount; null = the same as proven.
        - `maxDiscountsPerWalletPerDay` integer, nullable: Discount codes per unproven wallet per UTC day; null = no limit.
  - `meta` Meta
    - `version` string
    - `timestamp` string, date-time

## Other responses

- `400`: Invalid merchant ID format
- `404`: Merchant not found
- `500`: Unexpected server error. Safe to retry; no credits are charged on a 500. Router endpoints return the standard error envelope; standalone endpoints (the ones whose 200 is a flat object) return a flat {"error": "..."} object.

---

[API](https://skmtc.dev/insumermodel/apis/insumerapi.md) · [All operations](https://skmtc.dev/insumermodel/apis/insumerapi/llms.txt) · [OpenAPI document](https://skmtc.dev/insumermodel/apis/insumerapi/revisions/91f56fe9e3d8?raw)