> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sendoso.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Marketplace Products

> Retrieves a paginated list of all products in the marketplace catalog.

### Required Auth Scopes

`marketplace`

### Parameters

<ParamField query="after" type="string">
  The start  for cursor for pagination. This is returned in the `pagination`
  object of the previous response.
</ParamField>

<ParamField query="price_gte_usd" type="integer">
  The minimum price of products in USD.
</ParamField>

<ParamField query="price_lte_usd" type="integer">
  The maximum price of products in USD.
</ParamField>

<ParamField query="ship_to_country_codes[]" type="array<string>">
  The country codes to ship to.
</ParamField>

<ParamField query="category_ids[]" type="array<string>">
  Category IDs to filter products by.
</ParamField>

<ParamField query="text_search" type="string">
  Filter products by exact text search.
</ParamField>

### Response

<ResponseField name="pagination" type="object" required>
  Pagination information.

  <Expandable title="pagination">
    <ResponseField name="after" type="string">
      The cursor to use in the next request to fetch the next page of products.
    </ResponseField>

    <ResponseField name="next_page" type="object">
      <ResponseField name="url" type="string">
        The URL to fetch the next page of products.
      </ResponseField>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="categories" type="array" required>
  List of group of nested categories in the marketplace for the result set.

  <Expandable title="category">
    <ResponseField name="group_name" type="string" required>
      The name of the group of categories.
    </ResponseField>

    <ResponseField name="children" type="array" required>
      List of categories in the group.

      <Expandable title="category">
        <ResponseField name="id" type="string" required>
          The category's identifier. This is used to filter products by category.
        </ResponseField>

        <ResponseField name="name" type="string" required>
          The category's name.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="products" type="array" required>
  List of products in the marketplace

  <Expandable title="product" defaultOpen="true">
    <ResponseField name="id" type="string" required>
      The product's identifier.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      The product's name.
    </ResponseField>

    <ResponseField name="description" type="string" required>
      The product's description.
    </ResponseField>

    <ResponseField name="variants" type="array" required>
      List of product variants

      <Expandable title="variant" defaultOpen="true">
        <ResponseField name="id" type="string" required>
          The variant's identifier.
        </ResponseField>

        <ResponseField name="estimated_total_price" type="object" required>
          <ResponseField name="currency" type="string" required>
            The currency of the price.
          </ResponseField>

          <ResponseField name="price_per_unit" type="string" required>
            The price per unit.
          </ResponseField>
        </ResponseField>

        <ResponseField name="images" type="array" required>
          List of images

          <Expandable title="image" defaultOpen="true">
            <ResponseField name="url" type="string" required>
              The image's URL.
            </ResponseField>

            <ResponseField name="cdn_main" type="object" required>
              <ResponseField name="url" type="string" required>
                The main image's URL on a CDN (recommended).
              </ResponseField>
            </ResponseField>

            <ResponseField name="cdn_thumbnail" type="object" required>
              <ResponseField name="url" type="string" required>
                The thumbnail image's URL on a CDN.
              </ResponseField>
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>