GET v1​/ sell​/shop​/items​/:item_id

Endpoint to get details about an Item of the Shop.

Instant gratification

Do it yourself from console!

Assuming that you have a valid token previously exported into BEARER env variable and that 15953 is the ID of an Item of the current user.

Try to get info about Item 15953
curl --get -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/sell/shop/items/15953 \
-d 'currency=EUR'

Request

Example Request

{
  "currency": "EUR",
  "web_url": "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7"
}

Request Parameters

  • currency

    The currency in which the prices are exposed.

    • Required: no
    • Type: string
    • Example: "EUR"
  • web_url

    The URL on the web of this resource

    • Required: no
    • Type: string
    • Format: uri
    • Example: "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7"

Response

Example Response

{
  "id": "4047",
  "title": "foo",
  "currency": "EUR",
  "description": "",
  "raw_description": "A very very long description with HTML tags.",
  "published": true,
  "url": "http://example.org/sell/shop/items/4047",
  "created_at": "2013-05-03T15:52:46Z",
  "price": 25.0,
  "original_price": 25.0,
  "formatted_price_with_currency": "€25.00",
  "formatted_original_price_with_currency": "€25.00",
  "photos_id": [
    5168
  ],
  "photos": [
    "https://s3.amazonaws.com/cdn-staging.blomming.com/items/000/005/168/original/d876dabde8d650728233c1540052b6f9.jpg"
  ],
  "fbcomments": "http://blomming.com/items/115538/fbcomments",
  "shop": {
    "id": "jackdm85",
    "url": "http://example.org/shops/jackdm85",
    "items_url": "http://example.org/shops/jackdm85/items",
    "name": "jackdm85",
    "image": {
    },
    "payment_types": [
      {
        "code": "PCHECK",
        "description": "Personal Check"
      }
    ]
  },
  "quantity": 10,
  "prop_types": [
    {
      "name": "taglia",
      "id": 1,
      "values": [
        "32"
      ]
    }
  ],
  "skus": [
    {
      "id": 64314,
      "barcode": "c4bcfbf93bb8c42f01da3303d18836ad",
      "user_barcode": "spilla-1",
      "quantity": 42,
      "props": [
        {
          "value": "taglia",
          "type": {
            "name": "taglia",
            "id": 1
          }
        }
      ]
    }
  ],
  "shipping": {
    "profile_id": "1234",
    "profile_name": "Default",
    "origin_country": {
      "code": "IT",
      "name": "Italy"
    },
    "destinations": [
      {
        "code": "AT",
        "name": "Italy",
        "cost": {
          "single": 18,
          "shared": 0
        }
      }
    ],
    "everywhere_else_cost": null
  },
  "tags": [
    {
      "name": "pins",
      "items_url": "http://example.org/tags/pins/items"
    }
  ],
  "web_url": "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7",
  "categories": [
    {
      "id": 100,
      "name": "Clothing"
    }
  ],
  "sections": [
    ""
  ]
}

Response Parameters

  • id

    The ID of the Item.

    • Required: yes
    • Type: string
    • Example: "4047"
  • title

    The title of the Item.

    • Required: yes
    • Type: string
    • Example: "foo"
  • currency

    The currency in which the prices are exposed

    • Required: no
    • Type: string
    • Example: "EUR"
  • description

    The description of the Item.

    • Required: yes
    • Type: string
    • Example: ""
  • raw_description

    The description of the item with html tags

    • Required: yes
    • Type: string
    • Example: "A very very long description with HTML tags."
  • published

    the Item’s public visibility.

    • Required: yes
    • Type: boolean
    • Example: true
  • url

    The URL to fetch the details of the Item.

    • Required: yes
    • Type: string
    • Format: uri
    • Example: "http://example.org/sell/shop/items/4047"
  • created_at

    The date at which this Item has been created.

    • Required: yes
    • Type: string
    • Format: date-time
    • Example: "2013-05-03T15:52:46Z"
  • price

    The price of this Item in the currency passed as parameter

    • Required: yes
    • Type: string
    • Example: 25.0
  • original_price

    The origin (non-discounted) price of this Item in the currency passed as parameter.

    • Required: yes
    • Type:
      • string
      • null
    • Example: 25.0
  • formatted_price_with_currency

    The price with the currency of this Item

    • Required: yes
    • Type: string
    • Example: "€25.00"
  • formatted_original_price_with_currency

    The original (non-discounted) price with the currency of this Item

    • Required: yes
    • Type:
      • string
      • null
    • Example: "€25.00"
  • photos_id

    ???

    • Required: no
    • Type: array
    • Items

      ???

      • Required: no
      • Type: integer
      • Example: 5168
  • photos

    The photo of this Item with resolution XxY.

    • Required: no
    • Type: array
    • Items

      The URL of the photo

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "https://s3.amazonaws.com/cdn-staging.blomming.com/items/000/005/168/original/d876dabde8d650728233c1540052b6f9.jpg"
  • fbcomments

    The URL to display the facebook comments

    • Required: yes
    • Type: string
    • Format: uri
    • Example: "http://blomming.com/items/115538/fbcomments"
  • shop

    The properties of the Shop this Item belongs to.

    • Required: yes
    • id

      The id of the Shop this Item belongs to.

      • Required: yes
      • Type: string
      • Example: "jackdm85"
    • url

      The URL to fetch the details of the Shop to which this Item belong

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "http://example.org/shops/jackdm85"
    • items_url

      the url of the Items sold by this Shop.

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "http://example.org/shops/jackdm85/items"
    • name

      The name of the Shop.

      • Required: yes
      • Type: string
      • Example: "jackdm85"
    • image

      The logo of the Shop.

      • Required: yes
      • Type: uri
      • Format: uri
      • Example: "http://yourdomain.com/path/to/a/photo"
    • payment_types

      The payment types accepted by this Shop.

      • Required: yes
      • Type: array
      • Items

        A single payment type.

        • Required: yes
        • code

          The code of this payment type.

          • Required: yes
          • Type: string
          • Example: "PCHECK"
        • description

          A long description of the payment type.

          • Required: yes
          • Type: string
          • Example: "Personal Check"
  • quantity

    The number of Items in stock for this SKU.

    • Required: no
    • Type: integer
    • Example: 10
  • prop_types

    The definition of the properties of this Item.

    • Required: yes
    • Type: array
    • Items

      the properties

      • Required: no
      • name

        The name of the property type.

        • Required: yes
        • Type: string
        • Example: "taglia"
      • id

        The id of the property type.

        • Required: yes
        • Type: integer
        • Example: 1
      • values

        the possible values of this property.

        • Required: yes
        • Type: array
        • Items

          ???

          • Required: yes
          • Type: string
          • Example: "32"
  • skus

    An array containing all the SKU of a product.

    • Required: yes
    • Type: array
    • Items

      A single SKU

      • Required: yes
      • id

        The ID of the SKU, to be used to add item to the Cart.

        • Required: yes
        • Type: integer
        • Example: 64314
      • barcode

        the barcode of this SKU

        • Required: yes
        • Type: string
        • Example: "c4bcfbf93bb8c42f01da3303d18836ad"
      • user_barcode

        the shop defined barcode of this SKU.

        • Required: no
        • Type: string
        • Example: "spilla-1"
      • quantity

        The number of Items in stock for this SKU.

        • Required: yes
        • Type: integer
        • Example: 42
      • props

        The definition of the properties of this SKU.

        • Required: yes
        • Type: array
        • Items

          The properties

          • Required: yes
          • value

            The value of the property.

            • Required: yes
            • Type: string
            • Example: "taglia"
          • type

            The type of this property.

            • Required: yes
            • name

              The name of the property type.

              • Required: yes
              • Type: string
              • Example: "taglia"
            • id

              The id of the property type.

              • Required: yes
              • Type: integer
              • Example: 1
  • shipping

    The description of the Shipping Profile.

    • Required: yes
    • profile_id

      The ID of the Shipping Profile.

      • Required: yes
      • Type: string
      • Example: "1234"
    • profile_name

      The name of the Shipping Profile.

      • Required: yes
      • Type: string
      • Example: "Default"
    • origin_country

      The Country the Item is shipped from.

      • Required: yes
      • code

        The country code from which this object is sent.

        • Required: yes
        • Type: string
        • Example: "IT"
      • name

        The name of the country from which this object is sent.

        • Required: yes
        • Type: string
        • Example: "Italy"
    • destinations

      The destiation countries.

      • Required: yes
      • Type: array
      • Items

        The country.

        • Required: yes
        • code

          The country code.

          • Required: yes
          • Type: string
          • Example: "AT"
        • name

          The country name.

          • Required: yes
          • Type: string
          • Example: "Italy"
        • cost

          The cost of shipping to this country.

          • Required: yes
          • single

            The cost of shipping a single items.

            • Required: yes
            • Type: number
            • Example: 18
          • shared

            The cost of shipping multiple items.

            • Required: yes
            • Type: number
            • Example: 0
    • everywhere_else_cost

      The cost of shipping in a location not defined in the destinations array.

      • Required: yes
      • Type:
        • object
        • null
      • single

        The cost of shipping a single Item.

        • Required: yes
        • Type: number
        • Example: 25
      • shared

        The cost of shipping multiple Items.

        • Required: yes
        • Type: number
        • Example: 25
  • tags

    The Tags of this Item.

    • Required: yes
    • Type: array
    • Items

      A list of Tags associated to the Item.

      • Required: yes
      • name

        The name of the Tag.

        • Required: yes
        • Type: string
        • Example: "pins"
      • items_url

        The url to fetch all the Items with this Tag.

        • Required: yes
        • Type: string
        • Format: uri
        • Example: "http://example.org/tags/pins/items"
  • web_url

    The URL on the web of this resource.

    • Required: no
    • Type: string
    • Format: uri
    • Example: "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7"
  • categories

    A list of Categories the Item belongs to.

    • Required: yes
    • Type: array
    • Items

      A Category the Item belongs to.

      • Required: yes
      • id

        The ID of the Category.

        • Required: yes
        • Type: integer
        • Example: 100
      • name

        The name of the Category.

        • Required: yes
        • Type: string
        • Example: "Clothing"
  • sections

    An array containing all the Sections bound to this Item.

    • Required: yes
    • Type: array
    • Items

      A single Section associated to the Item.

      • Required: no
      • Type: string

Response Codes

Successful Response Codes

Failure Response Codes