Contents x
    Get information about an item by id
    • 4 Minutes to read
    • Print
    • Dark
      Light
    Contents

    Get information about an item by id

    • 4 Minutes to read
    • Print
    • Dark
      Light
    Article summary

    Get
    /items/{id}

    Fetches information about a garment. The garment format is implicitly set to detailed.

    Security
    API Key
    Header parameter namex-api-key
    API Key
    Header parameter namex-dressipi-jwt

    The JWT for the user

    Path parameters
    id
    stringRequired

    An identifier for the source item. The interpretation of this item is controlled by the identifier_type parameter

    Query parameters
    identifier_type
    string

    How dressipi should interpret the item id. Not all of these may be available, depending on the information in the product feed and how it is processed. Contact dressipi for examples of these types for your specific integration.

    In general

    • product-code is the style + color identifier from the feed
    • sku is style without color or size (can be supplemented with an extra parameter specifying the color + size variant)
    Valid values[ "dressipi-id", "ean", "gtin", "product-code", "sku", "ancillary-product-code" ]
    Default"product-code"
    pretty
    boolean

    If true, pretty print Json output. This increases response size and should usually be off in production environments

    include_dressipi_ids
    boolean

    Controls whether dressipi garment ids (raw_garment_id) are included in response

    Defaulttrue
    fields
    array of string

    A list of garment attributes to fetch. Only supported for garment_format=document or detailed. Custom fields may be available - contact dressipi for details

    locale
    string

    A locale parameter describing what stock information to use and what language to return text in (if applicable). This parameter will only function if the corresponding information is in the product feed & processed accordingly. If stock local and UI language are not the same, specify the language parameter in addition to this one.

    language
    string

    Allows you to specify a locale used for feed attributes such as product name that should be localized using a different locale to price & stock information. This parameter will only function if the corresponding information is in the product feed & processed accordingly.

    Responses
    200

    Information about the garment

    Expand All
    object

    Fetches information about a garment. The garment format is implicitly set to detailed.

    Example{ "garment_id": "01AC017NAV", "raw_garment_id": 4508067, "ancillary_product_code": "N-1-D-1111", "garment_category_id": 42, "garment_category_name": "Dresses", "department": "female", "has_outfits": true, "has_extended_verdicts": true, "size": { "exact": [ "5", "UK 10" ], "plus_one": [ "6", "UK 12" ], "minus_one": [ "4", "UK 8" ] }, "verdict": true, "owned": false, "why": [ "A neat slim leg flatters your slender shape", "A hint of flare helps to balance out your shoulders." ], "occasions": [ "casual", "holiday" ], "recommendedness": { "score": 8, "reason": "Good for you" }, "eans": [ "ABCD01", "ABCD02", "ABCD03" ], "features": [ { "id": 1, "name": "Basic", "feature_category_name": "Wardrobe" }, { "id": 2, "name": "A/W 2020", "feature_category_name": "Season" } ], "feed_image_urls": [ "https://assets.retailer.com/images/01AC017NAV", "https://assets.retailer.com/images/01AC017NAV" ], "brand_name": "Some Brand", "retailer": "Some Retailer", "name": "Black Maxi dress", "price": "35.00 GBP", "old_price": "35.00 GBP", "url": "https://www.someretailer.com/dresses/01AC017NAV", "garment_status": "in stock", "custom_attributes": [ { "name": "retailer_specific_attribute_1", "value": "abcedfg", "array_value": [] } ] }
    garment_id
    string

    The garment_id. The type of identifier used depends on the requests' garment_format

    ExampleABC-123
    raw_garment_id
    integer (int32)

    The internal dressipi id for the garment. This may be omitted depending on garment_format

    Example123456
    ancillary_product_code
    string

    An alternative identifier to identify the product, hidden when not provided in feed

    ExampleA1B2C3
    has_extended_verdicts
    boolean

    Whether garment has extended verdicts. Only presents for verdicts/dislikes, also not present if format=retailer_ids

    ExampleTrue
    has_outfits
    boolean

    Whether outfits can be generated. not present if format=retailer_ids

    size
    object (Sizing)
    exact
    Array of string

    Information about the recommended size

    string
    plus_one
    Array of string

    Information about size immediately bigger than the recommended one (if available)

    string
    minus_one
    Array of string

    Information about size immediately smaller than the recommended one (if available)

    string
    why
    Array of string

    If whys have been requested & if the profile has shape data, a list of human readable reasons for recommendation

    string
    verdict
    boolean

    If verdicts have been requested, the approval status of the garment (true=like, false=dislike, nil=no verdict given)

    owned
    boolean

    If owned has been requested, whether the use has previously purchased the product

    recommendedness
    object (Recommendedness)
    score
    integer (int32)

    A numerical score for the garment (out of 10)

    reason
    string

    A human readable interpretation of the score

    features
    Array of object (BasicFeature)

    If features have been requested, a list of whitelisted feature objects

    object
    id
    integer (int32)

    The id for the feature

    Example170
    name
    string

    The human readable name for the feature

    ExamplePlain Pattern
    feature_category_name
    string

    The feature category of the feature

    ExamplePattern
    garment_category_id
    integer (int32)

    The category id for the product.

    department
    string

    The garment department (female male girls boys).

    eans
    Array of string

    If eans have been requested, the array of eans present in the product feed.

    string
    garment_category_name
    string

    The category name for the product.

    occasions
    Array of string

    Array of the product occasions. Only present if format=detailed

    string
    retailer
    string

    The retailer name for the product. Only present if format=detailed

    feed_image_urls
    Array of string

    The array of image_urls present in the product feed. Only present if format=detailed

    string
    brand_name
    string

    The brand name for the product. Only present if format=detailed

    name
    string

    The product name. Only present if format=detailed

    price
    string

    The current price, as it appears in the feed. Only present if format=detailed

    old_price
    string

    The previous price, as it appears in the feed. Only present if format=detailed

    url
    string

    The URL for the PDP for the garment. Only present if format=detailed

    garment_status
    string

    The status of the garment. Only present if format=detailed

    custom_attributes
    Array of object (CustomAttribute)

    Product feed attributes, as agreed with dressipi

    object
    name
    string

    The name of the attribute

    value
    string

    The value of the attribute (if string valued)

    array_value
    Array of string

    The value of the attribute (if array valued)

    string
    422

    garment not found

    Expand All
    object

    Generic error object

    error
    object
    message
    string

    A human readable error message

    Was this article helpful?
    What's Next