---
title: "List pending claims on this merchant's domain (owner key only)"
method: GET
path: "/v1/merchants/{id}/claims"
tags: ["Merchant Setup"]
---

# List pending claims on this merchant's domain (owner key only)

`GET /v1/merchants/{id}/claims`

## Request

- Base URL: `https://api.insumermodel.com`
- URL: `https://api.insumermodel.com/v1/merchants/{id}/claims`
- Auth: API key in header `X-API-Key`

Domain-ownership dispute flow: when another party claims your verified domain, the claim queues here for your decision. Returns pending claims for the merchant's verified domain. 403 if this merchant is not the owner of record for the domain.

## Path parameters

- `id` string, required

## Response `200`

Pending claims (empty list if the merchant has no verified domain)

- object
  - `ok` boolean
  - `data` object
    - `domain` string, nullable
    - `claims` object[]
      - `id` string
      - `domain` string
      - `claimantCompanyId` string
      - `createdAt` string

## Other responses

- `401`: Missing or invalid API key
- `403`: API key does not manage this merchant, or not the owner of record for this domain
- `404`: Merchant not found
- `429`: Rate limit exceeded. API-key requests count against the key's daily limit; every authenticated response carries X-RateLimit-Limit and X-RateLimit-Remaining headers, and a 429 additionally carries Retry-After (seconds until the window resets).
- `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)