Products

List products

GET
/tenant/{tenantid}/product

Returns the products of a tenant. The key must have the view_product scope, and tenantid must be the tenant the key belongs to.

All query parameters are optional filters. Each takes a single value or a comma-separated list, for example type=service,set. A parameter other than id, type and category, a repeated parameter, or a value that is too long or contains other characters than letters, digits, _, - and , is rejected with 400 invalid_request.

Cost prices are never included in the response.

Authorization

bearerAuth
AuthorizationBearer <token>

The access_token from POST /oauth/token, sent as Authorization: Bearer <access_token>. Valid for one hour.

In: header

Path Parameters

tenantid*string

The tenant id of the API key.

Formatuuid

Query Parameters

id?string

Product id, or a comma-separated list of product ids.

Match^[A-Za-z0-9_,-]*$
Lengthlength <= 4000
type?string

Product type, or a comma-separated list of types.

Match^[A-Za-z0-9_,-]*$
Lengthlength <= 200
category?string

Category id, or a comma-separated list of category ids.

Match^[A-Za-z0-9_,-]*$
Lengthlength <= 4000

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tenant/00000000-0000-4000-8000-000000000001/product?id=00000000-0000-4000-8000-000000000001&type=service%2Cset&category=00000000-0000-4000-8000-000000000002"
{  "products": [    {      "id": "00000000-0000-4000-8000-000000000001",      "tenant": "00000000-0000-4000-8000-0000000000aa",      "name": "Example product",      "category": "00000000-0000-4000-8000-000000000002",      "price_rental": "12.50",      "vat_id": "00000000-0000-4000-8000-000000000003",      "type": "service",      "stock_type": "none",      "account_code_rental": null,      "account_code_sales": null,      "price_sales": "25.00",      "price_missing": null,      "allow_rental": true,      "allow_sales": true,      "daily_increase_factor_group": null,      "disable_daily_increase_factor": false,      "has_stock": false,      "info": {}    }  ]}

Laatst bijgewerkt op 8 oktober 2026