Designers

Typically, each item has a single designer, the brand, stylist or fashion house that created the original item. A designer record uses an id and human-readable name to uniquely identify each designer, alongside a formatted display name and shortened tag name for use in UI elements.

Designers Model

Designer

type Designer = {
id: string;
name: string;
displayName: string;
tagName?: string;
userSubmitted: boolean;
enabled: boolean;
createdAt: string;
updatedAt: string;
}

Unless excluded for specific use cases, items retrieved from the API will always include a single designer object with the fields shown above.

Collaborations

Sometimes items are the result of a collaboration between multiple designers In those cases, a hybrid designer entry will be created to represent the collab. For example, the internal name jean-paul-gaultier is used for the designer record of Jean Paul Gaultier while a separate record with the name jpg-knwls represents the collaboration between Jean Paul Gaultier and KNWLS. Not all designers in a collaboration will always have a distinct individual record.

Intrinsic values:

• id : a unique id in CUID format (generated by paralleldrive)
• name : a unique, human-readable internal name, lower-case-hyphenated, no whitespace
• displayName : Title-cased name for UI / Display, i.e. ‘Bottega Veneta’
• tagName : Shortened display name for use on Look Tags (optional)
• userSubmitted : was the value submitted by a user? defaults to false
• enabled : only items with enabled: true are included in API responses
• createdAt : item creation timestamp, ISO-8601 string format
• updatedAt : item updated timestamp, ISO-8601 string format

Endpoints

Designers Endpoint

$ curl /resources/designers | jq .
[
  {
    "id": "<some cuid>",
    "name": "16-arlington",
    "displayName": "16Arlington",
    "tagName": null,
    "userSubmitted": false,
    "enabled": true,
    "createdAt": "2024-06-18 23:00:34.054961+00",
    "updatedAt": "2024-06-18 23:00:34.054961+00"
  },
  {
    "id": "<some cuid>",
    "name": "acne-studios",
    "displayName": "Acne Studios",
    "tagName": null,
    "userSubmitted": false,
    "enabled": true,
    "createdAt": "2024-06-18 23:00:34.055534+00",
    "updatedAt": "2024-06-18 23:00:34.055534+00"
  },
  ...
]