---
title: "List marketplaces V1 (deprecated)"
method: GET
path: "/v1/marketplaces"
tags: ["Marketplace"]
deprecated: true
---

# List marketplaces V1 (deprecated)

`GET /v1/marketplaces`

## Request

- Base URL: `https://sandbox.pismolabs.io/marketplace`
- URL: `https://sandbox.pismolabs.io/marketplace/v1/marketplaces`
- Auth: HTTP bearer

> **Deprecated.**

List marketplaces using query parameters. This endpoint is **deprecated**. It is replaced by [List marketplaces](https://developers.pismo.io/pismo-docs/reference/getmarketplaces).

## Query parameters

- `merchant` number
- `search` string
- `page` number
- `perPage` number

## Headers

- `Authorization` string
- `Content-Type` string

## Response `200`

OK

- GETMarketplacesResponse
  - `pages` integer: Total number of pages
  - `per_page` integer: Number of result items per page
  - `total_items` integer: Total number of items
  - `current_page` integer: Current page number
  - `items` object[]: Found marketplaces
    - `id` integer: Marketplace ID
    - `name` string: Registered, legal marketplace name.
    - `brand_name` string: Marketplace brand name. A secondary name for the marketplace that is <b>not</b> the legal registered name.
    - `document_number` string: Marketplace document number. This is the government document code, such as a government-issued tax ID

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `500`: Internal server error
- `502`: Bad gateway (unexpected internal error)

---

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