---
title: "List marketplaces"
method: GET
path: "/v3/marketplaces"
tags: ["Marketplace"]
---

# List marketplaces

`GET /v3/marketplaces`

## Request

- Base URL: `https://sandbox.pismolabs.io/sellers`
- URL: `https://sandbox.pismolabs.io/sellers/v3/marketplaces`
- Auth: none declared

Retrieve a paginated list of marketplaces with optional filtering and sorting capabilities.

## Filtering

Filters are provided as individual query parameters. Multiple filters can be combined — each additional parameter further restricts the result set (AND logic).

| Parameter | Field Filtered | Match Type | Case Sensitive |
|---|---|---|---|
| `documentNumber` | `document_number` | Exact | Yes |
| `externalId` | `external_id` | Exact | Yes |
| `brandName` | `brand_name` | Partial (LIKE) | No |
| `marketplaceName` | `marketplace_name` | Partial (LIKE) | No |

**Examples:**
- `?documentNumber=12345678901234` — exact document number match
- `?brandName=Acme` — brand name containing "Acme"
- `?brandName=Acme&marketplaceName=Store` — brand name containing "Acme" AND marketplace name containing "Store"

## Sorting

Use `order` and `orderBy` to control result ordering.
Supported `orderBy` values: `marketplace_id`, `document_number`, `brand_name`, `marketplace_name`, `external_id`.
Default sort: `marketplace_id ASC`.

## Empty Results

Empty result sets return **HTTP 200** with an empty `items` array (not 404).

## Query parameters

- `page` integer
- `perPage` integer: Number of items per page
- `order` 'asc' | 'desc'
- `orderBy` string
- `documentNumber` string
- `externalId` string
- `brandName` string
- `marketplaceName` string

## Response `200`

OK - Paginated list of marketplaces

- GetMarketplacesResponse: Paginated list of marketplaces. `has_next` field indicates a next page is available
  - `has_next` boolean, required: Is a next page available?
  - `items` MarketplaceListItem[], required: Array of marketplace objects. Returns empty array if no results found (HTTP 200, not 404)
    - `brand_name` string, required: Brand name of the marketplace
    - `document_number` string, required: Marketplace document number
    - `id` integer, required: Marketplace ID
    - `marketplace_name` string, required: Registered marketplace name
    - `external_id` string, nullable: External system identifier
  - `page` integer, required: Current page number (starts at 1)
  - `per_page` integer, required: Number of items per page

## Other responses

- `400`: Bad request - Invalid query parameters
- `401`: Unauthorized
- `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)