Skip to main content

List all products

GET https://pos.paysera.com/eapi/v1/products

Retrieve a paginated list of products with optional filtering.

Authorization​

This endpoint requires a Personal Access Token, sent as a Bearer token.

To obtain one, your account needs API permission. Once granted, go to /user/settings in your POS account and create a personal access token.

Authorization Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

Example:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

For more details, see the Authentication section.

Parameters​

Query Parameters​

NameTypeRequiredDescription
pageSizeintegerNumber of items per page (min: 1, max: 200)
pageintegerThe current page number (min: 1)
createdAtFromstringFilter orders created on or after the specified UTC timestamp
createdAtTostringFilter orders created on or before the specified UTC timestamp
updatedAtFromstringFilter orders updated on or after the specified UTC timestamp
updatedAtTostringFilter orders updated on or before the specified UTC timestamp
keywordstringFree-text search matching the product title (any language), SKU or product code. Example: keyword=milk
categoryIdintegerFilter products belonging to the given product category id
skuarrayFilter products by a list of SKUs. Example: sku[]=MED-EKO-500&sku[]=MED-EKO-501
activebooleanFilter products by active status
pinPadViewbooleanWhen true, returns only products flagged to show in the PinPad view (isShownInPinPadView = true) β€” the dynamic goods/service keypad products. Combine with…
measureUnitarrayFilter products by a list of measure units. Example: measureUnit[]=unit&measureUnit[]=kg
sellChannelsarrayFilter products available in any of the specified sell channels. Example: sellChannels[]=pos&sellChannels[]=api
eanarrayFilter products by a list of EAN codes. Example: ean[]=1234567890123&ean[]=9876543210987
barcodearrayFilter products by a list of barcodes. Example: barcode[]=BC-MED-001&barcode[]=BC-MED-002
priceGreaterThanstringFilter products with a regular price greater than the specified value
priceLessThanstringFilter products with a regular price less than the specified value
specialPriceGreaterThanstringFilter products with a special price greater than the specified value
specialPriceLessThanstringFilter products with a special price less than the specified value

pinPadView​

When true, returns only products flagged to show in the PinPad view (isShownInPinPadView = true) β€” the dynamic goods/service keypad products. Combine with active / sellChannels to narrow further. Example: pinPadView=1

Errors​

This endpoint may return the following errors:

400 - Bad Request​

The request was invalid or cannot be served.

401 - Unauthorized​

Unauthorized

This error was produced by providing incorrect credentials.

403 - Forbidden​

Forbidden

This error indicates you don't have permission to access this resource.

404 - Not Found​

The requested resource could not be found.

405 - Method Not Allowed​

The requested HTTP method is not allowed for this resource.

422 - Unprocessable Entity​

The request was well-formed but was unable to be followed due to semantic errors.

429 - Too Many Requests​

You have exceeded the rate limit. Please try again in a minute.

500 - Internal Server Error​

Internal server error

Example​

Request​

GET https://pos.paysera.com/eapi/v1/products?pageSize=10&page=1&createdAtFrom=2023-01-01T00:00:00Z&createdAtTo=2023-12-31T23:59:59Z&updatedAtFrom=2023-01-01T00:00:00Z&updatedAtTo=2023-12-31T23:59:59Z
Authorization: Bearer YOUR_ACCESS_TOKEN

Response​

{
  "itemsTotal": 1,
  "pagesTotal": 1,
  "data": [
    {
      "id": 789,
      "sku": "MED-EKO-500",
      "type": "simple",
      "active": true,
      "title": {
        "lt": "Produkto pavadinimas",
        "en": "Product title"
      },
      "measureUnit": "unit",
      "taxId": 1,
      "price": {
        "regular": "9.99",
        "special": "7.99",
        "cost": "4.50"
      },
      "stock": {
        "quantity": "10",
        "manageStock": true,
        "useWarehouses": false
      },
      "categoryIds": [
        1,
        2
      ],
      "productCodes": [
        {
          "type": "ean",
          "code": "1234567890123"
        }
      ],
      "media": [
        {
          "url": "https://example.com/images/product.jpg",
          "sort": 0
        }
      ],
      "sellChannels": {
        "pos": true,
        "api": true
      },
      "isPriceDynamic": false,
      "isTitleDynamic": false,
      "isShownInPinPadView": false,
      "isShownInTouchView": true,
      "createdAt": "2026-04-20T12:00:00Z",
      "updatedAt": "2026-04-20T12:00:00Z",
      "attributes": {
        "5": [
          10,
          11
        ]
      },
      "optionGroups": [
        {
          "id": 5,
          "title": {
            "lt": "Dydis",
            "en": "Size"
          },
          "values": [
            {
              "id": 10,
              "title": {
                "lt": "MaΕΎas",
                "en": "Small"
              }
            }
          ]
        }
      ],
      "variants": [
        {
          "id": 7890,
          "sku": "MED-EKO-500-RED-S",
          "optionValueIds": [
            10,
            20
          ],
          "active": true,
          "price": {
            "regular": "9.99",
            "special": "7.99",
            "cost": "4.50"
          },
          "stock": {
            "quantity": "5"
          },
          "productCodes": [
            {
              "type": "ean",
              "code": "1234567890123"
            }
          ],
          "media": [
            {
              "url": "https://example.com/images/product.jpg",
              "sort": 0
            }
          ]
        }
      ]
    }
  ],
  "links": {
    "first": {
      "href": "string"
    },
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://pos.paysera.com
Query Parameters
pageSize
Number of items per page (min: 1, max: 200)
keyword
Free-text search matching the product title (any language), SKU or product code. Example: keyword=milk
categoryId
Filter products belonging to the given product category id
sku
Filter products by a list of SKUs. Example: sku[]=MED-EKO-500&sku[]=MED-EKO-501
active
Filter products by active status
pinPadView
When true, returns only products flagged to show in the PinPad view (isShownInPinPadView = true) β€” the dynamic goods/service keypad products. Combine with active / sellChannels to narrow further. Example: pinPadView=1
measureUnit
Filter products by a list of measure units. Example: measureUnit[]=unit&measureUnit[]=kg
sellChannels
Filter products available in any of the specified sell channels. Example: sellChannels[]=pos&sellChannels[]=api
ean
Filter products by a list of EAN codes. Example: ean[]=1234567890123&ean[]=9876543210987
barcode
Filter products by a list of barcodes. Example: barcode[]=BC-MED-001&barcode[]=BC-MED-002
priceGreaterThan
Filter products with a regular price greater than the specified value
priceLessThan
Filter products with a regular price less than the specified value
specialPriceGreaterThan
Filter products with a special price greater than the specified value
specialPriceLessThan
Filter products with a special price less than the specified value

RESPONSE

Successful Response
{
  "itemsTotal": 1,
  "pagesTotal": 1,
  "data": [
    {
      "id": 789,
      "sku": "MED-EKO-500",
      "type": "simple",
      "active": true,
      "title": {
        "lt": "Produkto pavadinimas",
        "en": "Product title"
      },
      "measureUnit": "unit",
      "taxId": 1,
      "price": {
        "regular": "9.99",
        "special": "7.99",
        "cost": "4.50"
      },
      "stock": {
        "quantity": "10",
        "manageStock": true,
        "useWarehouses": false
      },
      "categoryIds": [
        1,
        2
      ],
      "productCodes": [
        {
          "type": "ean",
          "code": "1234567890123"
        }
      ],
      "media": [
        {
          "url": "https://example.com/images/product.jpg",
          "sort": 0
        }
      ],
      "sellChannels": {
        "pos": true,
        "api": true
      },
      "isPriceDynamic": false,
      "isTitleDynamic": false,
      "isShownInPinPadView": false,
      "isShownInTouchView": true,
      "createdAt": "2026-04-20T12:00:00Z",
      "updatedAt": "2026-04-20T12:00:00Z",
      "attributes": {
        "5": [
          10,
          11
        ]
      },
      "optionGroups": [
        {
          "id": 5,
          "title": {
            "lt": "Dydis",
            "en": "Size"
          },
          "values": [
            {
              "id": 10,
              "title": {
                "lt": "MaΕΎas",
                "en": "Small"
              }
            }
          ]
        }
      ],
      "variants": [
        {
          "id": 7890,
          "sku": "MED-EKO-500-RED-S",
          "optionValueIds": [
            10,
            20
          ],
          "active": true,
          "price": {
            "regular": "9.99",
            "special": "7.99",
            "cost": "4.50"
          },
          "stock": {
            "quantity": "5"
          },
          "productCodes": [
            {
              "type": "ean",
              "code": "1234567890123"
            }
          ],
          "media": [
            {
              "url": "https://example.com/images/product.jpg",
              "sort": 0
            }
          ]
        }
      ]
    }
  ],
  "links": {
    "first": {
      "href": "string"
    },
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}