GET v1​/ shops​/:shop_id​/items​/:item_id

Endpoint to get details about an Item sold by a specific Shop.

:shop_id is a string that uniquely identify the Shop (aka username on Blomming web site); it is given by the /shops endpoint.

Instant gratification

Do it yourself from console!

Assuming that you have a valid token previously exported into BEARER env variable and that 10 is the item_id. of an Item sold by blomming Shop

See the details about a specific Item sold by blomming
curl -i -H "Authorization: Bearer $BEARER" \
https://api.blomming.com/v1/shops/blomming/items/10

Request

Example Request

{
  "currency": "EUR",
  "locale": "es"
}

Request Parameters

  • currency

    the currency to use when returning prices, the default is EUR.

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

    The locale used in the results

    • Required: no
    • Type: string
    • Example: "es"

Response

Example Response

{
  "title": "Orecchini uncinetto handmade",
  "description": "A very very long description without HTML tags.",
  "raw_description": "A very very long description with HTML tags.",
  "url": "https://api.blomming.com/v1/shops/lozoodisimona/items/115538",
  "id": "115538",
  "price": 25.0,
  "original_price": 25.0,
  "quantity": 42,
  "formatted_price_with_currency": "€25.00",
  "formatted_original_price_with_currency": "€25.00",
  "photos": [
    "https://s3.amazonaws.com/cdn.blomming.com/items/000/179/591/large/f569f44564d8b35283783430638d03c2.jpg?1346100986"
  ],
  "created_at": "2012-08-27T20:56:36Z",
  "web_url": "http://blomming.com/mm/luciapw/items/orecchini-uncinetto-handmade--7",
  "shop": {
    "id": "lozoodisimona",
    "url": "https://api.blomming.com/v1/shops/lozoodisimona",
    "name": "Lo Zoo di Simona",
    "image": {
    },
    "items_url": "http://example.org/shops/lozoodisimona/items",
    "payment_types": [
      {
        "code": "PCHECK",
        "description": "Personal Check"
      }
    ]
  },
  "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": {
    "origin_country": {
      "code": "IT",
      "name": "Italy"
    },
    "destinations": [
      {
        "code": "AT",
        "name": "Italy",
        "cost": {
          "single": 18,
          "shared": 0
        }
      }
    ],
    "everywhere_else_cost": null
  },
  "fbcomments": "http://blomming.com/items/115538/fbcomments",
  "currency": "EUR",
  "tags": [
    {
      "name": "pins",
      "items_url": "http://example.org/tags/pins/items"
    }
  ]
}

Response Parameters

  • title

    The title of the Item.

    • Required: yes
    • Type: string
    • Example: "Orecchini uncinetto handmade"
  • description

    The description of the Item.

    • Required: yes
    • Type: string
    • Example: "A very very long description without HTML tags."
  • raw_description

    The description of the Item with html tags.

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

    The URL to fetch the details of the Item.

    • Required: yes
    • Type: string
    • Format: uri
    • Example: "https://api.blomming.com/v1/shops/lozoodisimona/items/115538"
  • id

    The id of this Item.

    • Required: yes
    • Type: string
    • Example: "115538"
  • 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
  • quantity

    The number of Items present in the store.

    • Required: yes
    • Type: integer
    • Example: 42
  • 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

    The photo of this Item with resolution XxY.

    • Required: yes
    • Type: array
    • Items

      The URL of the photo.

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "https://s3.amazonaws.com/cdn.blomming.com/items/000/179/591/large/f569f44564d8b35283783430638d03c2.jpg?1346100986"
  • created_at

    The date at which this Item has been created.

    • Required: yes
    • Type: string
    • Format: date-time
    • Example: "2012-08-27T20:56:36Z"
  • web_url

    The URL on the web of this resource.

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

    The properties of the Shop’s this Item belongs.

    • Required: yes
    • id

      The id of the Shop this Item belong.

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

      The URL to fetch the details of the Shop to which this Item belongs.

      • Required: yes
      • Type: string
      • Format: uri
      • Example: "https://api.blomming.com/v1/shops/lozoodisimona"
    • name

      The name of the Shop.

      • Required: yes
      • Type: string
      • Example: "Lo Zoo di Simona"
    • image

      The logo of the Shop.

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

      the url of the Items sold by this Shop.

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

      The payment types accepted by this Shop.

      • Required: yes
      • Type: array
      • Items

        The list of payment types accepted by the Shop.

        • 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"
  • 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
    • origin_country

      ???

      • 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 items

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

        The cost of shipping multiple items

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

    The URL to display the facebook comments

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

    The currency in which the prices are exposed

    • Required: yes
    • Type: string
    • Example: "EUR"
  • tags

    The tags of this Item

    • Required: yes
    • Type: array
    • Items

      ???

      • Required: yes
      • name

        The name of the tag

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

        The url of the items with this tag

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

Response Codes

Successful Response Codes

Failure Response Codes