---
title: "Get marketplace by ID"
method: GET
path: "/v3/marketplaces/{marketplaceId}"
tags: ["Marketplace"]
---

# Get marketplace by ID

`GET /v3/marketplaces/{marketplaceId}`

## Request

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

Retrieve marketplace information by its ID.

Returns detailed information about a specific marketplace including its configuration, contact details, and address information.

## Path parameters

- `marketplaceId` integer, required: Marketplace ID

## Response `200`

Ok

- GetMarketplaceByIdResponse: Marketplace details returned by the endpoint that gets a marketplace by ID
  - `id` integer: Marketplace ID
  - `document_number` string: Marketplace document number
  - `brand_name` string: Marketplace brand name
  - `marketplace_name` string: Marketplace name
  - `registration` string: Official company registration with the local municipality
  - `registration2` string: Complementary registration number issued by local authorities. In certain countries, businesses may be required to hold multiple municipal registrations at national, state, or regional levels.
  - `external_id` string: Marketplace external identifier
  - `address` object: Marketplace address information
    - `street` string: Street address
    - `number` integer: Address number
    - `neighborhood` string: Field intended for entering the neighborhood name
    - `zip_code` string: ZIP/postal code
    - `city` string: City name
    - `state` string: State/province
    - `country` string: Country name
  - `contact` object: Contact information
    - `name` string: Contact person name
    - `email` string, email: Contact email
    - `phone_number` string: Primary phone number
    - `additional_phone_number` string: Secondary phone number

## Other responses

- `400`: Bad request
- `404`: Not found
- `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)