For the complete documentation index, see llms.txt. This page is also available as Markdown.

Products

Get Product from ChargePlan Id

get
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Responses
200

Success

application/json
idstring · uuidOptional
productNumberstring · nullableOptional
namestring · nullableOptional
productTypestring · enumOptionalPossible values:
categorystring · nullableOptional
activationDatestring · date-time · nullableOptional
endOfNewSalesDatestring · date-time · nullableOptional
endOfRenewalDatestring · date-time · nullableOptional
endOfLifeDatestring · date-time · nullableOptional
isFrameworkProductbooleanOptional
externalERPIdstring · nullableOptional
externalCRMIdstring · nullableOptional
createdstring · date-timeOptional
modifiedstring · date-timeOptional
legalEntityIdstring · uuidOptional
get/Products/FromChargePlan/{id}

Get Product from Charge Id

get
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Responses
200

Success

application/json
idstring · uuidOptional
productNumberstring · nullableOptional
namestring · nullableOptional
productTypestring · enumOptionalPossible values:
categorystring · nullableOptional
activationDatestring · date-time · nullableOptional
endOfNewSalesDatestring · date-time · nullableOptional
endOfRenewalDatestring · date-time · nullableOptional
endOfLifeDatestring · date-time · nullableOptional
isFrameworkProductbooleanOptional
externalERPIdstring · nullableOptional
externalCRMIdstring · nullableOptional
createdstring · date-timeOptional
modifiedstring · date-timeOptional
legalEntityIdstring · uuidOptional
get/Products/FromCharge/{id}

Get Product Features

get
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Query parameters
FilterstringOptional

Filter the results. See developer resources for more information. On endpoints whose entity supports custom fields you can also filter by custom field: customFieldEq('fieldName', 'value') (equals) or customFieldExist('fieldName') (field has a non-empty value). Custom-field functions may only be combined with and.

Example: name eq 'Adam' and age gt 20 and customFieldEq('region', 'EU')
OrderBystringOptional

Sorting the results. See developer resources for more information

Example: accountNumber Desc
ModifiedAfterstring · date-timeOptional

Apply a separate modified After filter. See 'ModifiedBefore' filter for further details.

Example: 2026-07-01
ModifiedBeforestring · date-timeOptional

Apply a separate filter to only get records that has been modified Before the specified date time.

Example: 2026-07-01
PageSizeinteger · int32Optional

Page Size

Example: 20
PageNumberinteger · int32Optional

Page Number

Example: 1
Header parameters
api-versionstringOptional
Responses
200

Success

application/json
pageNumberinteger · int32Optional
pageSizeinteger · int32Optional
totalPagesinteger · int32 · nullableOptional
totalCountinteger · int32Optional
nextPagestring · uri · nullableOptional
previousPagestring · uri · nullableOptional
firstPagestring · uri · nullableOptional
lastPagestring · uri · nullableOptional
get/Products/productFeatures

Create Product

post
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Header parameters
api-versionstringOptional
younium-idempotency-keystringOptional
younium-idempotency-durationInHoursintegerOptional
Body
productTypestring · enumOptionalPossible values:
namestring · nullableOptional
activationDatestring · date-time · nullableOptional
externalERPIdstring · nullableOptional
externalCRMIdstring · nullableOptional
Responses
201

Created

application/json
idstring · uuid · nullableOptional
messagestring · nullableOptional
post/Products

Get Products

get
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Query parameters
FilterstringOptional

Filter the results. See developer resources for more information. On endpoints whose entity supports custom fields you can also filter by custom field: customFieldEq('fieldName', 'value') (equals) or customFieldExist('fieldName') (field has a non-empty value). Custom-field functions may only be combined with and.

Example: name eq 'Adam' and age gt 20 and customFieldEq('region', 'EU')
OrderBystringOptional

Sorting the results. See developer resources for more information

Example: accountNumber Desc
ModifiedAfterstring · date-timeOptional

Apply a separate modified After filter. See 'ModifiedBefore' filter for further details.

Example: 2026-07-01
ModifiedBeforestring · date-timeOptional

Filter is also applied on sub entities: 'chargePlans', 'charges', 'chargeDetails' and 'customFields' on these entities

Example: 2026-07-01
PageSizeinteger · int32Optional

Page Size

Example: 20
PageNumberinteger · int32Optional

Page Number

Example: 1
Header parameters
api-versionstringOptional
Responses
200

Success

application/json
pageNumberinteger · int32Optional
pageSizeinteger · int32Optional
totalPagesinteger · int32 · nullableOptional
totalCountinteger · int32Optional
nextPagestring · uri · nullableOptional
previousPagestring · uri · nullableOptional
firstPagestring · uri · nullableOptional
lastPagestring · uri · nullableOptional
get/Products

Update Product

patch
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Body
productTypestring · enumOptionalPossible values:
namestring · nullableOptional
activationDatestring · date-time · nullableOptional
externalERPIdstring · nullableOptional
externalCRMIdstring · nullableOptional
Responses
204

No Content

No content

patch/Products/{id}

No content

Delete product

delete

A product can only be deleted if it's not in use on any active orders.

Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Responses
200

Success

No content

delete/Products/{id}

No content

Get Products by Id

get
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Responses
200

Success

application/json
idstring · uuidOptional
productNumberstring · nullableOptional
namestring · nullableOptional
productTypestring · enumOptionalPossible values:
categorystring · nullableOptional
activationDatestring · date-time · nullableOptional
endOfNewSalesDatestring · date-time · nullableOptional
endOfRenewalDatestring · date-time · nullableOptional
endOfLifeDatestring · date-time · nullableOptional
isFrameworkProductbooleanOptional
externalERPIdstring · nullableOptional
externalCRMIdstring · nullableOptional
createdstring · date-timeOptional
modifiedstring · date-timeOptional
legalEntityIdstring · uuidOptional
get/Products/{id}

Update Charge

patch
Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
chargeIdstring · uuidRequired
Header parameters
api-versionstringOptional
Body
namestring · nullableOptional
modelstring · enumOptionalPossible values:
chargeTypestring · enumOptionalPossible values:
externalCRMIdstring · nullableOptional
externalERPIdstring · nullableOptional
pricePeriodstring · enumOptionalPossible values:
usageRatingstring · enumOptionalPossible values:
measurementsRulestring · enumOptionalPossible values:
defaultQuantitynumber · double · nullableOptional
billingPeriodstring · enumOptionalPossible values:
periodAlignmentstring · enumOptionalPossible values:
billingDaystring · enumOptionalPossible values:
billingTimingstring · enumOptionalPossible values:
specificBillingDayinteger · int32 · nullableOptional
offsetBillingDaysinteger · int32 · nullableOptional
taxIncludedboolean · nullableOptional
Responses
204

No Content

No content

patch/Products/charges/{chargeId}

No content

Delete charge plan

delete

A charge plan can only be deleted if it's not in use on any active orders.

Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Responses
200

Success

No content

delete/Products/chargePlans/{id}

No content

Delete charges

delete

A charge can only be deleted if it's not in use on any active orders.

Required scopes
This endpoint requires the following scopes:
  • : Access Younium API
Authorizations
OAuth2passwordRequired
Token URL:
Path parameters
idstring · uuidRequired
Header parameters
api-versionstringOptional
Responses
200

Success

No content

delete/Products/charges/{id}

No content


Last updated