Article Item Service

  • Path: /v2/articles/items
  • Method: GET (read)
  • Authentication required: yes
  • Output formats: all formats
  • Output type: list
  • Field description:
    • id (string): Article number
    • uid (string): Unique internal ID to identify this item
    • title (string): Label
    • eancode (string): EAN code
    • collection (int)
    • collection_name (string)
    • collections (list of id and name): list of active collections (see below)
    • article_category_name (string)
    • article_type_name (string)
    • product_group (int)
    • product_group_name (string)
    • description (string)
    • nonbinding_price_recommendation (decimal)
    • nonbinding_price_recommendation_per_sqm (decimal)
    • image (string): URL of article image
    • room_image (string): URL of room image, if exists
    • dop_url (string): URL of the Declaration of Performance PDF document, if available
    • liner_material (int)
    • liner_material_name (string)
    • segment_type (int)
    • segment_type_name (string)
    • ambience_type (int)
    • ambience_type_name (string)
    • style_type (int)
    • style_type_name (string)
    • style_type_extra (string): Space-separated list of additional style types
    • pattern_type (int)
    • pattern_type_name (string)
    • inflammability (int)
    • inflammability_name (string)
    • overcoatable (boolean)
    • volume (decimal)
    • unit (int)
    • unit_name (string)
    • width (decimal)
    • length (decimal)
    • weight (decimal)
    • weight_per_sqm (decimal)
    • perimeter (decimal)
    • pattern_repeat_length (decimal)
    • pattern_repeat_width (decimal)
    • pattern_repeat_offset (decimal)
    • hue (string): Colouring of the item. Multiple values seperated by comma.
    • hue_name (string): Colouring label of the item. Multiple values seperated by comma.
    • packages_per_pallet (int): Number of packages per pallet
    • content_per_package (int): Number of items per package
    • package_width (decimal): Width of the package in cm
    • package_height (decimal): Height of the package in cm
    • package_length (decimal): Length of the package in cm
    • seal_ral (boolean)
    • seal_fsc (boolean)
    • seal_ctp (boolean)
    • seal_voc (boolean)
    • seal_tuev (boolean)
    • cl_water_resistance (int)
    • cl_water_resistance_name (string): Translated label (if available)
    • cl_color_fastness (int)
    • cl_color_fastness_name (string): Translated label (if available)
    • cl_repeat (int)
    • cl_repeat_name (string): Translated label (if available)
    • cl_glueing (int)
    • cl_glueing_name (string): Translated label (if available)
    • cl_processing (int)
    • cl_processing_name (string): Translated label (if available)
    • cl_method_removal (int)
    • cl_method_removal_name (string): Translated label (if available)
    • cl_miscellaneous (int)
    • cl_miscellaneous_name (string): Translated label (if available)
    • cl_material (int)
    • cl_material_name (string): Translated label (if available)
    • cl_mark_of_conformity (int)
    • cl_mark_of_conformity_name (string): Translated label (if available)
    • cl_permeability (int)
    • cl_permeability_name (string): Translated label (if available)
    • cl_washing (int)
    • cl_washing_name (string): Translated label (if available)
    • cl_bleaching (int)
    • cl_bleaching_name (string): Translated label (if available)
    • cl_tumble_drying (int)
    • cl_tumble_drying_name (string): Translated label (if available)
    • cl_ironing (int)
    • cl_ironing_name (string): Translated label (if available)
    • cl_dry_cleaning (int)
    • cl_dry_cleaning_name (string): Translated label (if available)
    • applicable_all (string)
    • applicable_livingroom (boolean)
    • applicable_childrensroom (boolean)
    • applicable_sleepingroom (boolean)
    • applicable_kitchen (boolean)
    • applicable_entrancehall (boolean)
    • applicable_bathroom (boolean)
    • matching_article_border (string)
    • matching_article_uni (string)
    • matching_article_pattern (string)
    • matching_article_fabric (string)
    • matching_article_pillow (string)
    • matching_article_carpet (string)
    • matching_articles (string): Space separated list of ID numbers of matching articles
    • complementary_articles (string): Space separated list of ID numbers of related articles
    • not_available_before (date | int): For articles that are not available yet, this column includes either the production date or 0 if no production date has been defined. For all other entries, this column is null.
    • discontinued (boolean)
    • country_of_origin (string): Country code of the manufacturing country
    • partie_groesse (float): Partiegröße (can be ignored by non-German customers)
    • packaging_unit (int): Number of articles per package
    • last_modified (date)
  • Filter parameters:
    • item=...: Comma-separated list of article numbers
    • collection=...: Comma-separated list of collection numbers
    • withoutExpiring=1: Hide items that will expire soon
  • Other parameters:
    • description=extended: Use an extended description that already contains a selection of attributes from the result set within the text. Currently only available with german labels.
    • withAllImages=1: Append all available images of this article. In JSON/XML, this will result in IMAGE being replaced by a List with additional information.
    • withAllCollections=1: Append a list of all active collections (see below)

This services provides access to our article data.

You can request the data of known articles, by providing a comma-separated list of articles numbers in the item=... query parameter. Without the parameter, you'll see the special article product line registered for your account. A special permission to list all articles is available. Please contact our sales department.

Important note: The price recommendation is NOT BINDING!

Meaning of collection

The fields collection and collection_name refer to the primary collection that this item is assigned to. In case of long-running articles the original collection may not be distributed anymore, but the article is used in several new collections. In these cases the article gets assigned to special collections like "Selection XY".

If you need the active collections the article is currently assigned to, you can append the parameter "&withAllCollection=1" to the service URL. In this case there will be a new element named collection which contains a list of id and name elements. Since CSV does not support lists within records the CSV output will be reduced to the collection ids. You can resolve them to names using articles/collections/.

Example

$ curl -s -o- -u :KEY 'https://rds.rasch.de/v2/articles/items?item=415407,480801&lang=en&withAllImages=1&withAllCollections=1'
[ {
  "id" : "415407",
  "uid" : 28304,
  "price" : null,
  "title" : "Selection 415407",
  "eancode" : "4000441415407",
  "code" : "",
  "gtin" : "04000441415407",
  "supplier_name" : "Gebr. Rasch GmbH & Co. KG",
  "supplier_gln" : "4000441000009",
  "collection" : 3211,
  "collection_name" : "Selection",
  "collections" : [ ],
  "article_category_name" : "Wallpapers, borders",
  "description" : "By the way: there is a gentle way to make waves. Like here, with colours of brown-grey, beige and glossy cream. Three delicate shades that create a modern, vibrant effect on the softly textured background  but without causing too much of a stir.",
  "recommended_retail_price" : 21.45,
  "recommended_retail_price_per_sqm" : 4.03,
  "field_recommended_retail_price_is_deprecated" : 1,
  "nonbinding_price_recommendation" : 21.45,
  "nonbinding_price_recommendation_per_sqm" : 4.03,
  "product_info_url" : "https://qr.rasch.de/4000441415407",
  "image" : [ {
    "id" : "36e9895e884445941c2173cdd37e7102",
    "url" : "https://rds.rasch.de/v2/assets/get/36e9895e884445941c2173cdd37e7102.jpg?colorspace=rgb",
    "width" : 1060,
    "height" : 1282,
    "category" : 100,
    "category_name" : "Artikelscan",
    "tile_repeat" : 0
  }, {
    "id" : "f66362dc9ad4e11c4ae914d47bc2002c",
    "url" : "https://rds.rasch.de/v2/assets/get/f66362dc9ad4e11c4ae914d47bc2002c.jpg?colorspace=rgb",
    "width" : 3543,
    "height" : 1992,
    "category" : 300,
    "category_name" : "Raumsituationen",
    "tile_repeat" : 1
  }, {
    "id" : "e49789c36784b1e3cec8531018a72903",
    "url" : "https://rds.rasch.de/v2/assets/get/e49789c36784b1e3cec8531018a72903.jpg?colorspace=rgb",
    "width" : 1181,
    "height" : 720,
    "category" : 400,
    "category_name" : "Rolle abgerollt",
    "tile_repeat" : 0
  } ],
  "room_image" : "https://rds.rasch.de/v2/articles/image/ambiente:415407.jpeg",
  "dop_url" : "https://rds.rasch.de/v2/dop/10/415407.pdf?lang=20",
  "article_type" : 5,
  "article_type_name" : "non-woven wallcovering",
  "product_group" : 80,
  "product_group_name" : "Screen printing",
  "liner_material" : 6,
  "liner_material_name" : "non-woven",
  "segment_type" : 10,
  "segment_type_name" : "white label",
  "ambience_type" : 5,
  "ambience_type_name" : "Basic",
  "style_type" : 20,
  "style_type_name" : "Graphic",
  "style_type_extra" : "20 50",
  "pattern_type" : 76,
  "pattern_type_name" : "Stripes",
  "tariff_code" : 48142000,
  "tariff_code_name" : "Wallpaper with synthetics",
  "hue" : "16,23,17",
  "hue_name" : "beige/cream, white, brown",
  "volume" : 3371,
  "unit" : "RO",
  "unit_name" : "Rolls",
  "unit_decimals" : 0,
  "width" : 53.0,
  "length" : 1005.0,
  "weight" : 0.822,
  "weight_per_sqm" : 0.154,
  "diameter" : 9.0,
  "perimeter" : 28.274,
  "pattern_repeat_length" : 0.0,
  "pattern_repeat_width" : 0.0,
  "pattern_repeat_offset" : 0.0,
  "packages_per_pallet" : 24,
  "content_per_package" : 12.0,
  "package_width" : 36.9,
  "package_height" : 53.8,
  "package_length" : 27.8,
  "inflammability" : 16,
  "inflammability_name" : "Wandbekleidung aus geschäumtem PVC mit einer Auskleidung aus Cellulosefaser oder Cellulose und Polyesterfaser",
  "overcoatable" : 0,
  "seal_ral" : 1,
  "seal_fsc" : 1,
  "seal_ctp" : 1,
  "seal_voc" : 1,
  "seal_tuev" : 0,
  "cl_water_resistance" : "3",
  "cl_water_resistance_name" : "highly wash-resistant",
  "cl_color_fastness" : "3",
  "cl_color_fastness_name" : "good",
  "cl_repeat" : "1",
  "cl_repeat_name" : "free match",
  "cl_glueing" : "0",
  "cl_glueing_name" : "not defined",
  "cl_processing" : "2",
  "cl_processing_name" : "paste the wall",
  "cl_method_removal" : "1",
  "cl_method_removal_name" : "completely strippable",
  "cl_miscellaneous" : "0",
  "cl_miscellaneous_name" : "not defined",
  "cl_material" : "0",
  "cl_material_name" : "not defined",
  "cl_mark_of_conformity" : "1",
  "cl_mark_of_conformity_name" : "Ü1 Z-159.10-16.  Schaumvinyl",
  "cl_permeability" : "0",
  "cl_permeability_name" : "not defined",
  "cl_washing" : null,
  "cl_washing_name" : null,
  "cl_bleaching" : null,
  "cl_bleaching_name" : null,
  "cl_tumble_drying" : null,
  "cl_tumble_drying_name" : null,
  "cl_ironing" : null,
  "cl_ironing_name" : null,
  "cl_dry_cleaning" : null,
  "cl_dry_cleaning_name" : null,
  "applicable_all" : 0,
  "applicable_livingroom" : 1,
  "applicable_childrensroom" : 0,
  "applicable_sleepingroom" : 1,
  "applicable_kitchen" : 0,
  "applicable_entrancehall" : 1,
  "applicable_bathroom" : 0,
  "matching_article_border" : "",
  "matching_article_uni" : "415346",
  "matching_article_pattern" : "",
  "matching_article_fabric" : "",
  "matching_article_pillow" : "",
  "matching_article_carpet" : "",
  "matching_articles" : "415308 415353",
  "complementary_articles" : "",
  "not_available_before" : null,
  "non_binding_expiration_year" : 2020,
  "discontinued" : 0,
  "country_of_origin" : "DE",
  "article_origin" : "Germany",
  "import_classification" : 48142000,
  "last_modified" : "2018-12-28",
  "image_last_modified" : "2015-11-16",
  "partie_groesse" : 24.0,
  "packaging_unit" : 12.0
}, {
  "id" : "480801",
  "uid" : 16607,
  "price" : null,
  "title" : "Selection 480801",
  "eancode" : "4000441480801",
  "code" : "",
  "gtin" : "04000441480801",
  "supplier_name" : "Gebr. Rasch GmbH & Co. KG",
  "supplier_gln" : "4000441000009",
  "collection" : 3211,
  "collection_name" : "Selection",
  "collections" : [ ],
  "article_category_name" : "Wallpapers, borders",
  "description" : "Ricamo / 480801",
  "recommended_retail_price" : 37.45,
  "recommended_retail_price_per_sqm" : 7.03,
  "field_recommended_retail_price_is_deprecated" : 1,
  "nonbinding_price_recommendation" : 37.45,
  "nonbinding_price_recommendation_per_sqm" : 7.03,
  "product_info_url" : "https://qr.rasch.de/4000441480801",
  "image" : [ {
    "id" : "b78a52a9a4141e43e6b724dae9bad026",
    "url" : "https://rds.rasch.de/v2/assets/get/b78a52a9a4141e43e6b724dae9bad026.jpg?colorspace=rgb",
    "width" : 1060,
    "height" : 1062,
    "category" : 100,
    "category_name" : "Artikelscan",
    "tile_repeat" : 0
  }, {
    "id" : "8c6f3de2bf9cff82035a089678102f48",
    "url" : "https://rds.rasch.de/v2/assets/get/8c6f3de2bf9cff82035a089678102f48.jpg?colorspace=rgb",
    "width" : 1600,
    "height" : 900,
    "category" : 300,
    "category_name" : "Raumsituationen",
    "tile_repeat" : 1
  }, {
    "id" : "4a2f2274fce822bfda7d6dca9335b873",
    "url" : "https://rds.rasch.de/v2/assets/get/4a2f2274fce822bfda7d6dca9335b873.jpg?colorspace=rgb",
    "width" : 2048,
    "height" : 2048,
    "category" : 400,
    "category_name" : "Rolle abgerollt",
    "tile_repeat" : 1
  } ],
  "room_image" : "https://rds.rasch.de/v2/articles/image/ambiente:480801.jpeg",
  "dop_url" : "https://rds.rasch.de/v2/dop/10/480801.pdf?lang=20",
  "article_type" : 3,
  "article_type_name" : "Hot emboss, paper, wallpaper",
  "product_group" : 90,
  "product_group_name" : "Hot embossed",
  "liner_material" : 3,
  "liner_material_name" : "Paper",
  "segment_type" : 20,
  "segment_type_name" : "taste",
  "ambience_type" : 10,
  "ambience_type_name" : "Classic",
  "style_type" : 45,
  "style_type_name" : "Classic Chic",
  "style_type_extra" : "",
  "pattern_type" : 48,
  "pattern_type_name" : "Patterns & motifs",
  "tariff_code" : 48142000,
  "tariff_code_name" : "Wallpaper with synthetics",
  "hue" : "40,41,42",
  "hue_name" : "beige, cream, yellow",
  "volume" : 2532,
  "unit" : "RO",
  "unit_name" : "Rolls",
  "unit_decimals" : 0,
  "width" : 53.0,
  "length" : 1005.0,
  "weight" : 1.214,
  "weight_per_sqm" : 0.228,
  "diameter" : 7.8,
  "perimeter" : 24.504,
  "pattern_repeat_length" : 0.0,
  "pattern_repeat_width" : 0.0,
  "pattern_repeat_offset" : 10.5,
  "packages_per_pallet" : 30,
  "content_per_package" : 12.0,
  "package_width" : 32.9,
  "package_height" : 53.8,
  "package_length" : 24.8,
  "inflammability" : 2,
  "inflammability_name" : "Wandbekleidung auf Cellulosefaserbasis mit Polymerbeschichtung oder -druck",
  "overcoatable" : 0,
  "seal_ral" : 0,
  "seal_fsc" : 1,
  "seal_ctp" : 0,
  "seal_voc" : 0,
  "seal_tuev" : 0,
  "cl_water_resistance" : "3",
  "cl_water_resistance_name" : "highly wash-resistant",
  "cl_color_fastness" : "3",
  "cl_color_fastness_name" : "good",
  "cl_repeat" : "2",
  "cl_repeat_name" : "straight match",
  "cl_glueing" : "0",
  "cl_glueing_name" : "not defined",
  "cl_processing" : "1",
  "cl_processing_name" : "paste the paper",
  "cl_method_removal" : "2",
  "cl_method_removal_name" : "peelable",
  "cl_miscellaneous" : null,
  "cl_miscellaneous_name" : null,
  "cl_material" : null,
  "cl_material_name" : null,
  "cl_mark_of_conformity" : "3",
  "cl_mark_of_conformity_name" : "Ü3 Z-159.10-30. Heißpräge<200g",
  "cl_permeability" : null,
  "cl_permeability_name" : null,
  "cl_washing" : null,
  "cl_washing_name" : null,
  "cl_bleaching" : null,
  "cl_bleaching_name" : null,
  "cl_tumble_drying" : null,
  "cl_tumble_drying_name" : null,
  "cl_ironing" : null,
  "cl_ironing_name" : null,
  "cl_dry_cleaning" : null,
  "cl_dry_cleaning_name" : null,
  "applicable_all" : 0,
  "applicable_livingroom" : 1,
  "applicable_childrensroom" : 0,
  "applicable_sleepingroom" : 1,
  "applicable_kitchen" : 0,
  "applicable_entrancehall" : 1,
  "applicable_bathroom" : 0,
  "matching_article_border" : "",
  "matching_article_uni" : "",
  "matching_article_pattern" : "",
  "matching_article_fabric" : "",
  "matching_article_pillow" : "",
  "matching_article_carpet" : "",
  "matching_articles" : "",
  "complementary_articles" : "",
  "not_available_before" : null,
  "non_binding_expiration_year" : 2019,
  "discontinued" : 0,
  "country_of_origin" : "DE",
  "article_origin" : "Germany",
  "import_classification" : 48142000,
  "last_modified" : "2019-01-09",
  "image_last_modified" : "2016-05-04",
  "partie_groesse" : 24.0,
  "packaging_unit" : 12.0
} ]