---
title: "List merchants linked to a marketplace"
method: GET
path: "/v1/marketplaces/{marketplaceId}/merchants"
tags: ["Marketplace merchants links"]
---

# List merchants linked to a marketplace

`GET /v1/marketplaces/{marketplaceId}/merchants`

## Request

- Base URL: `https://sandbox.pismolabs.io/sellers`
- URL: `https://sandbox.pismolabs.io/sellers/v1/marketplaces/{marketplaceId}/merchants`
- Auth: none declared

Returns information about the merchants linked to this marketplace

## Path parameters

- `marketplaceId` integer, required: Marketplace ID

## Query parameters

- `page` integer
- `perPage` integer: Number of items per page
- `subnet` 'individual' | 'hq' | 'branch'
- `hqId` integer
- `branchId` integer

## Response `200`

OK

- ListMarketplaceMerchantsLinkResponse: Paginated list of marketplaces. `has_next` field indicates a next page is available
  - `has_next` boolean, required: Is a next page available?
  - `items` object[], required
    - `id` integer: Merchant ID
    - `name` string: Merchant name
    - `document_number` string: Merchant document number
  - `page` integer, required: Current page number (starts at 1)
  - `per_page` integer, required: Number of items per page

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/seller-management-sellers.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-sellers/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-sellers/revisions/0b3b76e74a71?raw)