This is the main entrance for information regarding the APIs to access the Prodibas system.

Available API:s

These are the API "formats" available:

  • NEW: A RESTful API
  • A readonly RESTful API
  • A WCF (SOAP) service

The last two API formats have the same backend logic. Some of the functionality in the SOAP API is missing from the readonly REST API. Read more about the APIs here: Available APIs.

Getting started

If you are a new user of the Prodibas APIs, please visit Getting started to get up and running.

Latest updates

77 Release 2024-R06

2024-R06 - Release Notes API

Some uri types can now have "valid until" dates attached to them. See which types by using GlobalData GET /uritypes (for SOAP see GetUriTypes). Property ValidUntilEnabled should be true for these types.

New REST API now has a patch endpoint for uris for updating only "valid until" date for an existing uri.

76 Release 2024-R05

2024-R05 - Release Notes API

A new .NET SDK with sample usages of the new REST API is now available here: Examples

75 Release 2024-R04

2024-R04 - Release Notes API

New REST API now available in PROD environment

The new REST API is now available in the production environment. Read more here: Environments and here Available Apis.

New ExtNumber EPREL regnr

One new ExtNumber type has been added to the reference list, but is not yet active in the system: EPR (EPREL regnr). When set and in use, it will be used to download the documents:

  • ENERGYMARKINGDOC (Produktblad energimärkning)
  • ENERGYMARKINGLABEL (Energimärkningsetikett)
  • NESTEDEML (Nästlad energimärkningsetikett)

Read more here: Reference lists

New environmental property: PrecisionWeight

New property:

  • PrecisionWeight
on EnvironmentalData on ApiProduct.

74 Release 2024-R02

2024-R02 - Release Notes API

New property:

  • ConsistsOfNo
on ApiArticleAccessory. You can set and get ConsistsOfNo = Består av antal, on the relation type ConsistsOf.

73 Release 2023-R09

2023-R09 - Release Notes API

New properties:

  • EpdIdentifier
  • EpdReCalculationFactor
on EnvironmentalData on ApiProduct. If your company has EPD feature enabled, you can get and set these properties, otherwise they will always be null. Please contact support if you want to use these properties.

New read-only property StatisticGroup on ApiProduct. Will only ever contain value for SEG and if you have rights to view value.

72 Release 2023-R04

2023-R04 - Release Notes API

The method GetManyByIdentifiersQueued in both version 1 och 2 has a more correct behaviour. If duplicates are found (two products with the same number), all unique products are returned. Before an error occured when this happened.

New (optional) structured option for method GetManyByIdentifiersQueued in both version 1 och 2: StructuredFilterOptions. You can filter the output products on product active status: All, Active or Expired.

New field on APIProduct introduced in ProductService v2 for VVS: NameLongSvLong. The field is not used for SEG.

71 Release 2022-R09

2022-R09 - Release Notes API

The list containing ApiProductSVHCSubstance in the feature EnvironmentalData now contains up to six fields of SVHC Substances for SEG. For future use for VVS.

70 Release 2022-R07

2022-R07 - Release Notes API

The field FrostSensible is now obsolete and should not be used. It will always return null.

69 Release 2022-R05

2022-R05 - Release Notes API

New read-only property on product:

  • HasValidationErrors
True/False if product has existing validation errors. Updated by system in nightly validation batch.

68 Release 2022-R03

2022-R03 - Release Notes API

New EnvironmentalData feature is now being launched:

67 Release 2021-R10

2021-R10 - Release Notes API

A few more properties added to future container 'EnvironmentalData'. Do not use yet! New method in GlobalDataService: GetSVHCSubstances. For future use. Will only return empty list for now.

66 Release 2021-R09

2021-R09 - Release Notes API

Note: A future container 'EnvironmentalData' will now be visible on the ApiProduct, which can be toggled to be shown with a new structuredOutputOption ('EnvironmentalData') - when released. It will always return null for now, and you should just ignore it!

65 Release 2021-R07

2021-R07 - Release Notes API

Note: The outdated and should-not-be-used FlatService will be removed permanently.

64 Release 2021-R05

2021-R05 - Release Notes API

NEW: ExtNumber type and uri types

One new ExtNumber type has been added: SCI (SCIP ID). Two new Uri types have been added: ENERGYMARKINGDOC (Produktblad energimärkning) and ENERGYMARKINGLABEL (Energimärkningsetikett).

Read more here: Reference lists

63 Release 2021-R04

2021-R04 - Release Notes API

NEW: Version 2 of ProductService

A new version of ProductService API is now available (version 2).

Improvements in ProductService v2:

  • Removed obsolete or unimplemented service operations
  • Removed obsolete and irrelevant fields in ApiProduct
  • Better pagination functionality in SearchQueued
  • Replaced enums with strings (for easier agile versioning purposes)
  • Most fields are now non-required and nullable in ApiProduct

Documentation can be found here: ProductService v2

NEW: Added service operations in GlobalDataService

A few new service operations in GlobalDataService have been added:

BUGFIX: ArticleAccessories

It is now possible to update ArticleAccessories using the API. The container ArticleAccessoryFor was never populated before, it is now. This bugfix applies to both version 1 and version 2 of ProductService.

Read more here: ApiArticleAccessory

Internal ref


62 Release 2020-R11

2020-R11 - Release Notes API

A new option ProductGroupsVersion has been added in StructuredOutputOptions
This is the version of product group that should be returned. Default is active version. For VVS, set to 2 in order to retrieve the product's (or products') 4-level product group. The option is irrelevant for SEG.

New optional input parameter version to GetProductGroups in Global data service. For VVS, set version=2 in order to retrieve 4-level product groups. The parameter is irrelevant for SEG. Default is version 1.

New optional field in ApiProduct: PublishedAfterWholesaler. Used to pre-release the product för wholesalers.

Internal ref


61 Release 2020-R08

2020-R08 - Release Notes API

The value list of ApiProductStorageRequirementTypes have been updated. Read more here

Internal ref


Added 2020-09-02
TEST 2020-09-03
PROD 2020-09-10

New optional field: DangerousItemUnNumber replaces now obsolete field: DangerousItem
DangerousItem is now read-only with static value of None.
DangerousItemUnNumber contains UN-number.

Internal ref


Added 2020-07-21
TEST 2020-08-31
PROD 2020-09-10

60 Release 2020-R04

2020-R04 - Release Notes API

We have added 6 new optional fields in ApiProduct:

Read more about the Bvb fields here
The fields cannot be updated, only read

Internal ref


Added 2020-04-16
TEST 2020-04-16
PROD 2020-06-03
Read more

59 Release 2019-R12

2019-R12 - Release Notes API

We have added a new property ProductMini in StructuredOutputOptions
This is for a future implementation and should not be used in this version.
The SOAP API Service contract has not changed.

Internal ref


Added 2019-12-10
TEST 2019-12-10
PROD 2019-12-19

58 Release 2019-R11

2019-R11 - Release Notes API

We have started building a REST API with functions from the SOAP API.
In this work we have changed a lot in the internal machinery of the API functions as they will serve two API interfaces in the future.
The SOAP API contract has not changed.

Run SOAP api with https

Now we have added the opportunity to run the SOAP API with https.
Add "secure" at the end of the URI to the web service
Example TEST:
Example PROD:

Correction of function GetManyByIdentifiersQueued

The GetManyByIdentifiersQueued feature has been in the API contract but has never been used. It also turned out to have a bug that we have now fixed.
You can submit the same type of identifiers (search keys) as for GetByIdentifier and GetSingleByIDentifier
If you send in identifiers that give duplicates of product, only one product is returned.
Articles that does not get a hit are NOT reported back because the API contract does not support this and we do not want to break it.
Note that this is an asynchronous method that returns a queue ID (QueueId). The result is usually checked with GetResult.
It is possible to use PingBackURL to get a signal when the result is clear.
Number of articles: Our recommendation is not to search for more than 500 items in a call.

Correction of GetUpdateResult .NET API SDK

We found that the GetUpdateResult method did not handle WorkNotReadyFault correctly.
This was due to a mismatch between the namespace for SOAP Faults in the SDK's proxy for the SOAP service and the SOAP service itself.
We had not updated SDK's proxy client at an earlier time.
The SDKs are now corrected and now they match.

Internal ref


Added 2019-12-02
Availability Test 2019-11-27
Availability PROD 2019-12-02

57 Value of TypeId in ApiProductExtNumber was not set

BUG: ApiProductExtNumber - TypeId value was always 0

See ApiProduct External numbers (ApiProductExtNumber) for more information.

Internal ref

Internal ref numbers VVS-1618

Added 2019-09-20
Availability Test 2019-09-20
Availability PROD 2019-09-23

56 Updated documentation regarding UriTypes

IMPROVEMENT: New dynamic view of avalable URI-types

See ApiProduct Uri-types for more information.

Internal ref

Internal ref numbers VVS-1316

Added 2019-09-05
Availability Test 2019-09-05

55 Updated documentation regarding image scaling

IMPROVEMENT: Urls and recommendations about scaling of images.

See About scaling of images for more information.

Internal ref

Internal ref numbers VVS-1559

Added 2019-09-04
Availability Test 2019-09-04

54 Bugfix for updating ETIM-values

BUG: Changning ETIM-value resulted in error missing content access

When updating etimvalues server responded with error message

"Missing content access for field 'Etim.EFnnnnn'" 
even though user had access to ETIM-data.
See ApiProduct ApiEtimProductData for more information.

Internal ref numbers VVS-1605

Added 2019-09-09
Availability PROD 2019-09-09

53 Bugfix for readonly fields

BUG: Some readonly fields were wrongly seen as changed by the caller

See ApiProduct for more information.

Ignoring these fields in update methods


  • NumberStr
  • IsWholesalerApproved
  • ReplacedByNumberStr

SEG only

  • ReplacedPartlyByNumberStr
  • ReplacesNumberStr
  • ReplacesPartlyNumberStr

Internal ref numbers VVS-1604

Added 2019-09-09
Availability PROD 2019-09-09

52 Changes in fields

IMPROVEMENT: Added fields DescriptionEn, GroupingWord and ProductModel.

See ApiProduct for more information.

Note field DescriptionEn
DescriptionEn replaces the field NameLongEn for longer english description.

  • is ordered in the ApiProduct Structure in the SOAP-body or SOAP-response. (After BulletText)
  • Is set to be not required when updating.

CHANGE: NameLongEn

New meaning for NameLongEn which now contains the longer english name for the product.

Internal ref

Internal ref numbers VVS-1454, VVS-1423 and VVS-1581

Added 2019-08-13
Availability Test 2019-08-20

51 IMPROVEMENT: Added field IsWholesalerApproved

See ApiProductPackage for more information.

Added 2019-08-13
Availability Test 2019-08-13

50 IMPROVEMENT: ProductService improved behaviour in GetByIdentifier and GTIN.

As a manufacturer you can only search within your own products. As a manufacturer you have to provide your own manufactureridentifuer or leave it blank
Have a look at ProductIdentifiers ByManufacturerAndArticleGTIN

Added 2019-05-08
Availability Test 2019-05-08

49 IMPROVEMENT: ProductService Added faultcontract InternalErrorFault to IProductService.

Added Faultcontract InternalErrorFault to all methods in IProductService for a more robust error handling and return.

Added 2019-04-15
Availability Test 2019-04-16

48 BUGFIX: ProductService GetResult and GetUpdateResult when work not ready(VVS-1503).

ProductService GetResult and GetUpdateResult wrongly returned a WorkNotProcessedException instead of WorkNotReadyException.
This now fixed.

Added 2019-03-27
Availability Test 2019-03-27 Prod 2019-03-27

47 BUGFIX: Fixed a bug for User SafeWater (VVS-1497).

Added 2019-03-13
Availability Test 2019-03-12 Prod 2019-03-13

46 BUGFIX: Fixed a bug regarding Count and CountWithDecimals in ApiProductPackage (VVS-1443).

Added 2018-12-20
  • Count and CountIsSpecified are now optional
  • Changed logic for use of these fields

See ApiProductPackage for more information.

Availability Test 2018-1220

45 Added optional field ReachVersionOfCandidateList in ApiProduct and extended validation for REC-type (VVS-1436).

Added 2018-12-07
Availability Test 2018-12-07

44 Added field in APIProductPackage and changes in handling of package levels (VVS-1243).

Added 2018-11-29

Added fields CountWithDecimals and CountWithDecimalsIsSpecified, CountWithDecimals is also added as a return value.
For measurements M and M2 you have to use CountWithDecimals.

The field Count will remain, but is to be considered as obsolete and will be deprecated in the future.

The number of levels for ProductPackages changes from three to four by adding Mellan2 (SortOrder=3).
it is also possible to skip levels if desired.

All packages specified as level 3 (Top in the old specification) will be updated to level 4 prior to this update being released.

See ApiProductPackage for more information.

Availability Test 2018-11-29

43 Added parameter in SearchProductsParameters for SearchQueued (VVS-1419)

Added 2018-10-25

For Productservice Search. Added parameter LastChangedOptionSearchGreaterThanOnly for managing behaviour of comparision of lastChanged.

See SearchProductsParameters for more info.

Availability TEST environment 2018-10-25

42 Added fields in ApiProduct (VVS-1419)

Added 2018-10-23

Added readonly fields in the following structures


  • ReplacedByNumberStr


  • ReplacedPartlyByNumberStr
  • ReplacesNumberStr
  • ReplacesPartlyNumberStr

Availability TEST environment 2018-10-23

41 BUGFIX: Fixed bug in SearchQueued (VVS-1419)

Added 2018-10-23

In Productservice Search. Filter criteria didn't work for these fields in SearchProductsParameters.

  • ActiveStatus
  • InfoLevel
  • EtimClassIdentifier

Availability TEST environment 2018-10-23

40 Fixed bug regarding fields seemed changed by user but were not (VVS-1391)

Added 2018-10-16

Bug occured when updating products.

For these fields

  • BulletText
  • Description
  • NameEn
  • NameLongEn
  • NameLongSv
  • NameSv
  • OtherInfo

Availability TEST environment 2018-10-16

39 Updated documentation on ProductService

Added 2018-10-16

Update info on Productservice.

Mainly behaviour on using product identifiers has been straightened up.

When using update functions as the role manufacturer you are only authorized to update your own products. Read more here.

Availability TEST environment 2018-10-16

38 New ApiProduct-field NumberStr

Added 2018-09-28

General information for the added field NumberStr on ApiProduct.

Availability TEST environment 2018-09-28

37 Pingback functionality enabled for queued requests

Modified 2018-09-26 (VVS-1389)

The PingbackUrl Option when using SearchQueued and UpdateQueued is now enabled.

Availability TEST environment 2018-09-26

36 ProductService - Search restriction for manufacturers

Modified 2018-09-21 (VVS-1384)

As a manufacturer you may only search your own products. Please enter your ManufacturerId into search options. An error will be thrown otherwise.Productservice.
Notes on search parameters: SearchProductsParameters

Availability TEST environment 2018-09-21

36 ProductService - Search restriction

Modified 2018-09-06 (VVS-1373)

Added validation and restrictions on search options to use at least one esarch filter parameter.Productservice.
Notes on search parameters: SearchProductsParameters

Availability TEST environment 2018-09-06

35 ProductService - Search by ProductGroup

Modified 2018-08-22 (VVS-1367)

Added search options for searching by ProductGroupId or ProductGroupIdentifier in Productservice.
Notes on search parameters: SearchProductsParameters
Product Groups can be retreived with the method GetProductGroups in GlobalDataService

Availability TEST environment 2018-08-22

34 FlatService - Minor update in error reporting

Modified 2018-05-18 (VVS-1324)

Updated UpdateArticlesInner in FlatService to just report ETIM-errors and not any existing errors on product.

Availability PROD and TEST environment 2018-05-18

33 BUGFIX: UpdateManyQueued - Error when trying to update a product that does not exist

Modified 2018-04-03 (VVS-1296)

In Productservice.
Got System.NullReferenceException when trying to update a produt that does not exist.
Fixed so API now returns a better error message stating that the product could not be found and what product-key that caused the problem.

Availability Test environment 2018-04-03

32 BUGFIX: Error while updating StorageRequirement and DangerousItem

Modified 2018-03-28 (VVS-1291 )

In Productservice. Notes on properies and values : ApiProduct
An error occured when trying to update the properties StorageRequirement and DangerousItem

Availability Test environment 2018-03-28

31 API supports updates of ETIM-data

Modified 2018-03-27 (VVS-1280)

In Productservice. Notes on properies and values : ApiProduct ApiEtimInfo
Updating ETIM-data is now supported. (Documentation on this is currently a work in progress, we apologise for this)

Availability Test environment 2018-03-27

30 BUGFIX: Bugfixes related to Queued-functions

Modified 2018-03-21 (VVS-1280)

In Productservice and CandidateService.
Error when updating or importing many products with the same picture/document. Only the first product was updated. wich resulted in File not found validation errors for the remainig products.

Availability Test environment 2018-03-21

29 BUGFIX: Bugfixes related to Queued-functions

Modified 2018-03-21 (VVS-1280)

In Productservice. Internal error when getting results from UpdateManyQueued using method GetUpdateResult
In Productservice Reference to Article/product in error messages was wronlgy prefixed with "MANU" insstead of "ART"

Availability Test environment 2018-03-21

28 BUGFIX: Improved Handling of Carriagereturn and Linefeed and invalid characters

Modified 2018-03-20 (VVS-1280)

In Productservice. Fields that can contain CRLF (x0D x0A) or just CR (x0D) is converted to LF (x0A)
Cleans invalid XML-characters from these fields as well. W3-standard documentation about XML and Linebreaks Affected fields in APiProduct

  • NameEn
  • NameSv
  • NameLongEn
  • NameLongSv
  • Description
  • BulletText
  • OtherInfo

Availability Test environment 2018-03-20

27 Handling of Carriagereturn and Linefeed, BUGFIX: Handling of ETIM-data

Modified 2018-03-15 (VVS-1280)

Fields that can contain CRLF (x0D x0A) or just CR (x0D) is converted to LF (x0A) W3-standard documentation about XML and Linebreaks Affected fields in APiProduct

  • NameEn
  • NameSv
  • NameLongEn
  • NameLongSv
  • Description
  • BulletText
  • OtherInfo

Corrected a bug in the handling of parameter ETIM in StructuredOutputOptions when using method SearchQueued in Productservice. A value of 0 still loaded ETIM-data.

Availability Test environment 2018-03-15

26 Bugfix UpdateManyQueued processing

Modified 2018-03-05 (VVS-1273)

Bugfix: Fixed UpdateManyQueued to correctly process all products. Only the first 10 were processed. Productservice

Availability Test environment 2018-03-05

25 Bugfix UpdateManyQueued with documents

Modified 2018-03-03 (VVS-1208)

Bugfix: Fixed UpdateManyQueued to correctly update documents and images Productservice
Documentation: Updated documentation for ApiProduct with field-lengths for string-fields ApiProduct

Availability Test environment 2018-03-02

24 Bugfix reading products with ETIM-data

Modified 2017-11-20 (VVS-1208)

Bugfix: Fixed GetByIdentifier-methods error when etim-group had enddate

Availability Test environment 2017-11-20

23 Bugfix reading products

Modified 2017-11-17 (VVS-1209)

Bugfix: Fixed GetByIdentifier-methods error when searching by GTIN

Availability Test environment 2017-11-17

22 ETIM-features

Modified 2017-08-28

Bugfix: Fixed Get-methods returned duplicates of ETIM-data
ApiProduct ApiEtimInfo

Availability Test environment 2017-08-28

21 ETIM-features

Modified 2017-07-18

Added option to include ETIM-data for retrieved products in Get-methods
ApiProduct ApiEtimInfo

Availability Test environment 2017-07-18

20 Restructured .NET example

Modified 2017-02-15

Removed unsolved external reference to assembly. Moved tools code to project.

Availability Test environment version 2017-R01 hotfix

19 New product-field BulletText

Added 2017-01-02 Modified 2017-01-30

General support for the added field BulletText on ApiProduct.

Modified 2017-01-30 Field BulletText appears last.

Availability version 2017-R01

18 Updates of ExtNumbers and Packages

Import methods of CandidateService and update methods of ProductService support new fields now

Availability Test 2016-11-25 Stage Production

17 Updates


  • Added method GetByIdentifier - returns many products per number if exist
  • Changed behaviour GetSingleByIdentifier - active return


  • Import - Error if trying to update candidate with ID that is already a product

Availability Test 2016-11-24 Stage Production

16 Updates


  • Bugfix method - GetCandidateGroupsFiltered SearchById prevents reading wrong manufacturer

Availability Test 2016-10-27 Stage Production

15 Updates


  • Fixed method - GetCandidateGroupsFiltered doing a bad database request

Availability Test 2016-10-20 Stage Production

14 Updates


  • Added new method - GetCandidateGroupsFiltered with corresponding parameters
  • Added field BecameRevisionDate to ApiCandidateItem
  • BUGFIX: Setting BecameRevisionDate for imported candidates

Availability Test 2016-10-20 Stage Production

13 Updates


  • Bug fixed in GetCandidateGroups. Row references are now returned as correct ranges

Availability Test 2016-10-07 Stage Production

12 Updates


  • Updated GetCandidateGroups which returned too many items per candidate group and product group
  • Fixed bug regarding authentication calling GetSingleByIdentifier

Availability Test 2016-10-06 Stage Production

11 Updates

Changed Names for the following types

  • ApiProductManufacturer renamed to ApiManufacturerInProduct
  • ApiProductStorageRequirement renamed to ApiProductStorageRequirementTypes

ApiProduct Changes

  • ProductGroupId field removed
  • ManufacturerIdentifier field removed

Removed following types

  • Parameters.ApiProductInfoLevelType Removed

ApiCandidateImportResult Changes

  • ProductIdentifier field added

Availability Test 2016-09-09 Stage Production

10 Updates

Changed response type for ICandidateService.ImportWithGroupedResult to ApiCandidateImportGroupedResult

Bugfix: Import returns validation errors as it should. Bug returned duplcates.

ApiManufacturer Renamed following fields

  • ResponsibleAdminInfo
  • ResponsibleDocsInfo
  • ResponsibleImagesInfo
  • ResponsibleCEOInfo
  • ResponsibleMarketInfo
  • ResponsibleEconomyInfo

Availability Test 2016-09-09 Stage Production

9 Updates

Updated ApiProduct with fields for manufacturer (Name Alias, Id and Identifier) Documentation for ApiProductManufacturer

Availability Test 2016-08-10 Stage Production

8 Updates

New service Documentation for ManufacturerService

Availability Test 2016-06-07 Stage Production

7 Updates

Candidate import
New method ImportWithGroupedResult.


  • ApiProduct New field : ProductId
  • ApiProduct New field : SeriesName
  • ApiProduct New fields : BvbResult, BvbVersion, BvbId

CandidateService - Candidate Import

  • Updates are keyed on ProductId

Candidate import and product update can take document parameters to upload documents and images.
Documentation for CandidateService Documentation for ProductService

New methods GetProductGroups GetUriTypes.
Documentation for GlobalDataService

Availability Test 2016-05-11 Stage Production

6 Products SearchQueued and SearchAsBmecatQueued support splitting batches

Use parameter TakeApproximately to split up huge results.

Availability Test 2016-04-07 Stage Production

5 SOAP action namespace, removed tempuri

All SOAP actions are now in correct namespace Prodibas.API.V1, tempuri has been removed.

Availability Test 2015-12-10 Stage 2016-04-04 Production 2016-04-04

4 GlobalDataService more methods implemented

Methods GetUnits(), GetCountries(), GetDangerousItems(), GetStorageRequirements(), GetPackageTypes(), GetPackagingFunctions(), GetPalletTypes() are now implemented.

Availability Test 2015-12-10 Stage 2016-04-04 Production 2016-04-04

3 Model validation

ModelValidationError and ModelValidationException are now in correct namespaces.

Availability Test 2015-11-23 Stage 2016-04-04 Production 2016-04-04

2 ApiProduct class changed to non-generic

For simplicity the ApiProduct<IndustrySpecificAbstractBase> has been changed to ApiProduct. You should still use property IndustrySpecific for industry-specific information. This change gives you shorter and simpler class names in the WSDL contract.

Availability Test 2015-11-23 Stage 2016-04-04 Production 2016-04-04

1 Updated SDK and examples

  • The queued queries now delay 5 seconds before making the first GetResult() request. This makes it more likely to receive a result on the first GetResult() request for small batches.
  • Examples now use test-manufacturers including their API-keys. Directly executable.
Availability Test 2015-11-20 Stage 2016-04-04 Production 2016-04-04