Skip to content

Get products ​

Returns a list of all the products which can be ordered using the API. The request might take some time since it will return all the products at once. Cache the results of the request if you need it often. Because of the sheer quantity of products we added segmentation. You can get the segments for photoframes and photobooks with the designated "filter" query params.

Endpoint ​

KeyValue
URLhttps://api.profotonet.nl/v1/products
MethodGET
Query params (optional)?filter=photoframes or ?filter=photobooks

Response object ​

FieldTypeDescription
productIdIntegerThe unique id of the product used in an entry.
nameStringFull name of the product.
priceIntegerPrice of the product in cents.
optionsArrayArray with optional options.
options[].nameStringName of the option.
options[].codeStringCode of the option used in an entry.
options[].attributesArrayArray of possible attributes of the option.
options[].attributes[].nameStringName of the attribute.
options[].attributes[].codeStringCode of the attribute used in an entry.
shippingMethodsArrayArray of shippingMethods used for this product.
shippingMethods[].nameStringName of the shippingMethod.
shippingMethods[].pricingObject (key-value)Key-value object containing the prices for the countries. ISO-3166 country codes are used as key for countries with a special price and "default" is set for the rest of the possible countries. The value is the price in cents. Note: the item with the highest shipping price is used as the shipping price for the order.

Example of objects in the response (real response is much, much larger!) ​

json
{
  "productId": 1002201300190001,
  "name": "Schoolfotoset A - Papiersoort: Glans",
  "price": 127,
  "options": [
    {
      "name": "Witte randen",
      "code": "whiteborder",
      "attributes": [
        {
          "name": "Witte randen",
          "code": "checked"
        }
      ]
    },
    {
      "name": "Optimalisatie",
      "code": "optimalisation",
      "attributes": [
        {
          "name": "Optimalisatie",
          "code": "checked"
        }
      ]
    }
  ],
  "shippingMethods": [
    {
      "name": "Brievenbuspost via PostNL",
      "pricing": {
        "default": 349,
        "nl": 249
      }
    },
    {
      "name": "Brievenbuspost als pakket via PostNL",
      "pricing": {
        "default": 899,
        "nl": 599
      }
    }
  ]
},
{
    "productId": 1003705000500003,
    "name": "Canvas 2cm (50 x 50) - Houten baklijst: Wit",
    "price": 8195,
    "options": [
      {
        "name": "Afwerking randen",
        "code": "canvasedge",
        "attributes": [
          {
            "name": "Geen bewerking",
            "code": "none"
          },
          {
            "name": "Uitrekken",
            "code": "stretch"
          },
          {
            "name": "Spiegelen",
            "code": "mirror"
          },
          {
            "name": "Wit laten",
            "code": "white"
          }
        ]
      }
    ],
    "shippingMethods": [
      {
        "name": "Pakketpost via PostNL",
        "pricing": {
          "default": 899,
          "nl": 599
        }
      }
    ]
  }