GET
/
catalogue
/
products
/
{id}
curl -X GET \
 /catalogue/products/{id} \
 --header "Authorization: Bearer <token>"
{
  "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
  "productFamilies": [
    {
      "id": "ad8b3b9e-5b0a-4e1a-8b0a-4e1a8b0a4e1a",
      "name": "Team Packages"
    }
  ],
  "name": "Basic",
  "description": "For small teams.",
  "internalName": "Basic (Weekly)",
  "number": "M-1234",
  "translations": {},
  "type": "product",
  "measurement": {
    "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
    "unit": {
      "id": {},
      "name": "Stück",
      "translations": {}
    },
    "code": "users",
    "description": "The number of users.",
    "aggregationType": "<any>",
    "fairBilling": true,
    "type": "<any>"
  },
  "pricePlans": [
    {
      "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
      "internalName": "Exclusive pricing for partners.",
      "status": "<any>",
      "salesChannel": {},
      "type": "<any>",
      "applyTrial": true,
      "payInAdvance": true,
      "proRata": true,
      "freeUnits": {},
      "billingInterval": "1M",
      "showPricePerInterval": "1M",
      "currencyCode": {},
      "price": {
        "amount": 123,
        "createdAt": "2021-01-01T00:00:00+00:00",
        "updatedAt": "2021-01-01T00:00:00+00:00",
        "tenantId": "<string>"
      },
      "custom": true,
      "charge": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
      "productSetOption": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
      "product": "<any>",
      "customer": "<any>",
      "inUse": true,
      "checkoutLinkIds": [
        "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b"
      ]
    }
  ],
  "invoiceVisibility": "always",
  "costCentre": {
    "id": "ad8f1c9c-4f0a-4e1a-8b1a-9c4d9c4d9c4d",
    "name": "Cost Centre",
    "code": "CC",
    "type": "KOST1",
    "createdAt": "2021-01-01T00:00:00+00:00",
    "updatedAt": "2021-01-01T00:00:00+00:00"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "taxGroup": {
    "id": "00000000-0000-0000-0000-000000000000",
    "internalDescription": "19%",
    "reverseChargeType": "REVERSE_CHARGE",
    "type": "standard"
  },
  "isArchived": true,
  "customFields": {
    "field1": "value1",
    "field2": "value2"
  }
}

Authorizations

​
Authorization
string
header
required

Value for the Authorization header parameter.

Path Parameters

​
id
string
required

Product identifier

Response

200
application/json
Product resource
​
productFamilies
object[]
required

A product family groups multiple products together.

​
translations
object
required

The translations of the product. The locale is used as key.

​
type
enum<string>
required

The type of the product.

  • product: recurring billed product
  • charge: one-time billing
  • plan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
Available options:
product,
charge,
plan
​
measurement
object
required

The measurement that is used for the price plan. This could define the quantity or a metered usage.

​
taxGroup
object
required

The tax group that is used for the product.

​
id
string

The unique identifier of the product.

Example:

"ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b"

​
name
string

The name of the product based on the current tenant language. This will be displayed on customer communication.

Example:

"Basic"

​
description
string | null

The description of the product based on the current tenant language.

Example:

"For small teams."

​
internalName
string | null

Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.

Example:

"Basic (Weekly)"

​
number
string | null

Internal product number

Required string length: 2 - 255
Example:

"M-1234"

​
pricePlans
object[]

The price plans of the product. Describes multiple prices which could be selled by this product.

​
invoiceVisibility
enum<string>

Defines when the product should be displayed in the invoice.

  • always: The product is always displayed in the invoice.
  • only_if_charged: The product is only displayed in the invoice if it is charged.
Available options:
always,
only_if_charged
​
costCentre
object | null

The cost centre is used for accounting exports.

​
createdAt
string
​
updatedAt
string
​
isArchived
boolean

Defines if the product is archived and should not be used anymore.

​
customFields
object | null

Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide

Example:
{ "field1": "value1", "field2": "value2" }