---
title: "List public marketing preferences for an organisation"
method: GET
path: "/customers/show-marketing-preferences"
tags: ["MarketingPreferences"]
---

# List public marketing preferences for an organisation

`GET /customers/show-marketing-preferences`

Returns the marketing preferences (e.g. "email me about offers")
that an organisation has defined for public display on
unauthenticated signup flows. The response is a stripped-down
projection — only the preference ID and display text — so the
payload is safe to expose on a public webpage.

Use this to populate the consent checkboxes on a guest-facing
signup form before the customer has any login credentials.
Once the customer registers, switch to
[`listCustomerMarketingPreferences`](#operation/listCustomerMarketingPreferences)
to read or update their personal opt-in state.

This endpoint is public — no authentication is required.

## Query parameters

- `organisation_id` string, uuid, required

## Response `200`

The public marketing preferences were successfully retrieved.

- object
  - `data` PublicMarketingPreference[], required
    - `id` string, uuid, required — The ID of the marketing preference.
    - `text` string, required — The text to display next to the consent checkbox.

## Other responses

- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)