StylorDocs

Get the profile

get/v1/shoppers/me

The shopper's profile in words: the styles learnt from their reactions, what they lean toward and away from, the notes and sizes kept for them, and their body measurements. Never the vectors behind it. Show it on a "your profile" screen, with a way to forget each part.

Public keyapi.v1.shoppersDemo key OK

Headers

1
X-Shopper-Tokenstringrequired

The shopper's profile token, from auth/start, auth/verify or any call that made a profile.

Response

200The profile.
ShopperProfilerequired

A profile in words. Never the vectors behind it.

savedbooleanrequired

true once the shopper confirmed an email: the profile is theirs, lasts until they delete it, and works at every store that runs Stylor.

emailstringnullablerequired

The confirmed email. Null on an anonymous profile.

array<object>required

Styles learnt from their reactions, strongest first. At most four per slot.

array<object>required

Kinds of whole look they liked, strongest first.

array<object>required

Styles they passed on often enough to say.

likesarray<string>required

Labels they clearly lean toward, read from their reactions, never said by them ("colour: black"). At most 8.

avoidsarray<string>required

Labels they clearly lean away from. At most 8.

array<object>required

What they told you, kept with remember.

array<ShopperKeptSize>required

Sizes they wear, by brand or store.

ShopperBody | nullrequired

Their body measurements in centimetres, and how they like things to fit. Null when none are kept.

signalsintegerrequired

Reactions learnt from.

Errors

22

Every error is JSON with a single error string unless noted. Match on the status code; the message is for humans.

401
Send the shopper's token in x-shopper-token, or start a profile (auth/start).

No X-Shopper-Token was sent.

401
That shopper token is not valid here. Start a profile or sign in again.

X-Shopper-Token was sent but cannot be opened with this key.

403
Shopper profiles are switched off for this organization.

The organization turned shopper profiles off.

curl -X GET "https://stylor.ai/api/v1/shoppers/me" \
  -H "Authorization: Bearer $STYLOR_API_KEY"
Response · 200
{
  "profile": {
    "saved": true,
    "email": "[email protected]",
    "styles": [
      {
        "id": "3f9a1c2e",
        "name": "black, relaxed, t shirt",
        "slot": "top",
        "strength": 7.4
      }
    ],
    "outfits": [
      {
        "id": "8c2d4e6f",
        "name": "all neutrals, separates",
        "strength": 3
      }
    ],
    "avoidStyles": [
      {
        "id": "5b7e9a1d",
        "name": "floral, dress",
        "slot": "one-piece"
      }
    ],
    "likes": [
      "colour: black",
      "fit: relaxed"
    ],
    "avoids": [
      "pattern: floral"
    ],
    "notes": [
      {
        "id": "a1b2c3d4",
        "text": "Starting a new office job in March",
        "kind": "occasion"
      }
    ],
    "sizes": [
      {
        "brand": "Levi's",
        "slot": "bottom",
        "kind": "jeans",
        "label": "30",
        "fit": "right"
      }
    ],
    "body": {
      "waist": 76,
      "hips": 98,
      "height": 168,
      "fit": "relaxed",
      "unit": "cm"
    },
    "signals": 24
  }
}