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).

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).

{
  "has_next": true,
  "items": [
    {
      "brand_name": "Acme Corporation",
      "document_number": "12345678901234",
      "id": 51148,
      "marketplace_name": "Acme Store",
      "external_id": "EXT-123"
    }
  ],
  "page": 1,
  "per_page": 10
}