Skip to main content
GET
/
account
/
api
/
v1
/
preferences
List the caller's stored trait preferences
curl --request GET \
  --url https://www.closient.com/account/api/v1/preferences \
  --header 'X-API-Key: <api-key>'
[
  {
    "trait": "<string>",
    "trait_label": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.closient.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

Response

200 - application/json

OK

trait
string
required

Lower-snake-case slug for the trait — pass directly into search constraints like exclude_allergens / require_certifications depending on the category.

trait_label
string
required

Human-readable trait name as stored on Trait.name.

category
enum<string>
required

Which axis the trait sits on. ALLERGEN preferences feed exclude_allergens; DIETARY / RELIGIOUS / SOURCING feed require_certifications.

Available options:
ALLERGEN,
DIETARY,
RELIGIOUS,
SOURCING,
OTHER
stance
enum<string>
required

How the user feels about the trait. AVOID / REQUIRE are hard filters; PREFER is a ranking boost; NEUTRAL is recorded but not acted on.

Available options:
AVOID,
REQUIRE,
PREFER,
NEUTRAL