> ## 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 Gift Recommendations

> Retrieves a list of recommendations for a given recipient email.

### Required Auth Scopes

`smartsend`

### Parameters

<ParamField query="recipient_email" type="string" required>
  The email of the recipient.
</ParamField>

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

<ParamField query="ship_to_country_code" type="string">
  The country codes to ship to.
</ParamField>

### Response

<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="interests" type="array<string>" required>
      List of interests based on which the product was recommended.
    </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>
