PEpennylane
Products

List products

Changed on

List products

ℹ️ This endpoint requires one of the following scopes: products:all, products:readonly

get/api/external/v2/products

Request

  • Base URL
    https://app.pennylane.com
  • URL
    https://app.pennylane.com/api/external/v2/products
  • Auth
    OAuth 2
    Authorization code: https://app.pennylane.com/oauth/authorize
    Token URL: https://app.pennylane.com/oauth/oauth/token scopes: products:all, products:readonly

Query parameters

cursorstring
Example:dXBkYXRlZF9hdDoxNjc0MTIzNDU2

Cursor for pagination. Use this to fetch the next set of results. The cursor is an opaque string returned in the previous response's metadata. Leave empty for the first request.

limitinteger
Example:20

Number of items to return per request. Defaults to 20 if not specified. Must be between 1 and 100.

filterstring
Example:[{"field": "id", "operator": "eq", "value": "42"}]

You can choose to filter items on specific fields. Available fields and values:

  • id : lt, lteq, gt, gteq, eq, not_eq, in, not_in
  • label : eq, in
  • reference : eq, in
  • external_reference : eq, not_eq, in, not_in
sortstring

You can choose to sort items on specific attributes Sort field may be prefixed with - for descending order. Example : id will sort by ascending order, -id will sort by descending order. Available fields : id

Headers

X-Company-Idstring
Example:12345

Numeric ID of the company to act on. Required when authenticating with a firm token. Ignored when the token is already bound to a company.

Response

A list of Products

has_moreboolean required

Indicates whether additional results are available beyond this set. Use this flag to determine if another request is needed.

next_cursorstring nullable required

Cursor to retrieve the next set of results. Include this value in the cursor parameter of your next request to fetch subsequent items. A null next_cursor in the response indicates no further results.

Example response

{
  "has_more": true,
  "next_cursor": "dXBkYXRlZF9hdDoxNjc0MTIzNDU2",
  "items": [
    {
      "id": 1,
      "label": "Product 1",
      "description": "This is product 1",
      "external_reference": "0e67fc3c-c632-4feb-ad34-e18ed5fbf66a",
      "price_before_tax": "12.5",
      "vat_rate": "FR_200",
      "price": "13.6",
      "unit": "piece",
      "reference": "REF-123",
      "archived_at": "2023-09-30T10:08:08.146343Z",
      "created_at": "2023-08-30T10:08:08.146343Z",
      "updated_at": "2023-08-30T10:08:08.146343Z",
      "custom_fields": [
        {
          "name": "color"
        }
      ]
    }
  ]
}

Changes

  • 871f863307e5Revision changes
    • warning

      added the new DE_intracom_exempt_BU0233 enum value to the // response property for the response status

    • warning

      added the new ES_intracom_sales_goods enum value to the // response property for the response status

    • warning

      added the new ES_intracom_sales_services enum value to the // response property for the response status

    • warning

      added the new ES_isp_purchases_100 enum value to the // response property for the response status

    • warning

      added the new ES_isp_purchases_210 enum value to the // response property for the response status

    • warning

      added the new ES_isp_sales enum value to the // response property for the response status

    • warning

      added the new ES_suplido enum value to the // response property for the response status

    • warning

      added the new VES enum value to the // response property for the response status

    • info

      added the new optional header request parameter X-Company-Id

    • info

      removed the mixed enum value from the // response property for the response status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status