Get Showcase Offer

Resolve a read-only offer projection. Suitable for landing pages, pricing widgets, or anonymous browsing where:

• the customer may not be known,
• no transaction is being prepared,
• you only need the catalog/price/campaign rendering data.

URL

POST /api/c2a/offer/showcase

Request Parameters

Body: GetShowcaseOfferRequest.

Name	Type	Description
context	object (GetShowcaseOfferContext)	Required. Showcase resolution context. Structurally similar to GetBundlesContext but does not require customerUrn.

GetShowcaseOfferContext is not safe to feed back into checkout — the engine may have skipped customer-specific eligibility checks.

Request Example

{
  "context": {
    "storefrontUrn": "st.00.001",
    "promotionCode": "CMP1WKWAFY",
    "clientPlatformType": "Web"
  }
}

Response Parameters

Same GetOfferResponse envelope as Get Bundles. The returned offer.presentationType is typically a showcase-friendly value, and artifactGroups are calculated without customer-specific overlays.

Sample Response

{
  "status": { "messageCode": "SUCCESS" },
  "offer": {
    "offerIdentifier": "sh_8z2k1q",
    "presentationType": "Showcase",
    "productGroupType": "RecurringSubscription",
    "storefrontUrn": "st.00.001",
    "artifactGroups": [
      {
        "bundleUrn": "bn.00.42",
        "name": "Pro Monthly",
        "price": { "amountMilpieces": 1499, "currency": "EUR" }
      }
    ]
  }
}

Behaviour

• Don't pass a showcase offerIdentifier to /c2a/offer/checkout. The Offer engine treats showcase results as non-transactable; checkout will reject them with OFFER_NOT_PURCHASABLE.
• Showcase results are caching-friendly — they can be returned faster than a personalised purchase offer.

Sample Codes

cURL

curl --location 'https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase' \
  --header 'Content-Type: application/json' \
  --header 'x-tn: e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f' \
  --header 'x-api-key: sk_dev_acme_sample_123456789' \
  --data '{
    "context": {
      "storefrontUrn": "st.00.001",
      "promotionCode": "CMP1WKWAFY",
      "clientPlatformType": "Web"
    }
  }'

JavaScript

const res = await fetch('https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-tn': 'e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f',
    'x-api-key': 'sk_dev_acme_sample_123456789'
  },
  body: JSON.stringify({
    context: {
      storefrontUrn: 'st.00.001',
      promotionCode: 'CMP1WKWAFY',
      clientPlatformType: 'Web'
    }
  })
});
console.log(await res.json());

Node.js

import { request } from 'undici';

const { body } = await request('https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-tn': 'e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f',
    'x-api-key': 'sk_dev_acme_sample_123456789'
  },
  body: JSON.stringify({
    context: {
      storefrontUrn: 'st.00.001',
      promotionCode: 'CMP1WKWAFY',
      clientPlatformType: 'Web'
    }
  })
});
console.log(await body.json());

Python

import requests

res = requests.post(
    "https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase",
    headers={
        "Content-Type": "application/json",
        "x-tn": "e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f",
        "x-api-key": "sk_dev_acme_sample_123456789",
    },
    json={
        "context": {
            "storefrontUrn": "st.00.001",
            "promotionCode": "CMP1WKWAFY",
            "clientPlatformType": "Web",
        }
    },
)
print(res.json())

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String json = """
{
  "context": {
    "storefrontUrn": "st.00.001",
    "promotionCode": "CMP1WKWAFY",
    "clientPlatformType": "Web"
  }
}
""";

HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase"))
    .header("Content-Type", "application/json")
    .header("x-tn", "e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f")
    .header("x-api-key", "sk_dev_acme_sample_123456789")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();
HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

C#

using System.Net.Http.Json;

var payload = new {
    context = new {
        storefrontUrn      = "st.00.001",
        promotionCode      = "CMP1WKWAFY",
        clientPlatformType = "Web"
    }
};

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-tn", "e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f");
http.DefaultRequestHeaders.Add("x-api-key", "sk_dev_acme_sample_123456789");

var res = await http.PostAsJsonAsync(
    "https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase",
    payload);
Console.WriteLine(await res.Content.ReadAsStringAsync());

PHP

<?php
$payload = [
    'context' => [
        'storefrontUrn'      => 'st.00.001',
        'promotionCode'      => 'CMP1WKWAFY',
        'clientPlatformType' => 'Web',
    ],
];

$ch = curl_init('https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-tn: e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f',
        'x-api-key: sk_dev_acme_sample_123456789',
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload),
]);
echo curl_exec($ch);
curl_close($ch);

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]any{
        "context": map[string]string{
            "storefrontUrn":      "st.00.001",
            "promotionCode":      "CMP1WKWAFY",
            "clientPlatformType": "Web",
        },
    }
    body, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST",
        "https://acme.sandbox.azotte.com/api/v1/c2a/offer/showcase",
        bytes.NewReader(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("x-tn", "e2a1c7b2-4f3a-4b8e-9c2d-1a2b3c4d5e6f")
    req.Header.Set("x-api-key", "sk_dev_acme_sample_123456789")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    fmt.Println(string(out))
}