Orders

Get any version of a SalesOrder or Subscription by id.

get

Can be used when an orderId can be both a SalesOrder and a Subscription and any version. Response body will be either a SalesOrderResponse or a SubscriptionResponse.

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

Responses

200

Success

No content

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

404

Not Found

application/json

get

/Orders/{id}

HTTPcURLJavaScriptPython

GET /Orders/{id} HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Get Charge by Id

get

Get any version of a subscription or a sales order Charge.

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

Responses

200

Success

application/json

idstring · uuidOptional

chargeNumberstring · nullableOptionalExample: OPC-000001

versioninteger · int32Optional

isLastVersionbooleanOptional

namestring · nullableOptional

chargeTypeall ofOptional

string · enumOptionalPossible values:

priceModelall ofOptional

string · enumOptionalPossible values:

effectiveStartDatestring · date-time · nullableOptional

effectiveEndDatestring · date-time · nullableOptional

quantitynumber · double · nullableOptional

unitCodestring · nullableOptional

startOnall ofOptional

string · enumOptionalPossible values:

endOnall ofOptional

string · enumOptionalPossible values:

chargedThroughDatestring · date-time · nullableOptional

lastRenewalDatestring · date-time · nullableOptional

lastPriceAdjustmentDatestring · date-time · nullableOptional

pricePeriodall ofOptional

string · enumOptionalPossible values:

usageRatingall ofOptional

string · enumOptionalPossible values:

revenueRecognitionRulestring · nullableOptional

billingDayall ofOptional

string · enumOptionalPossible values:

specificBillingDayinteger · int32Optional

offsetBillingDaysinteger · int32 · nullableOptional

billingPeriodall ofOptional

string · enumOptionalPossible values:

billingTimingall ofOptional

string · enumOptionalPossible values:

periodAlignmentall ofOptional

string · enumOptionalPossible values:

alignmentDatestring · date-time · nullableOptional

taxTemplatestring · nullableOptional

taxIncludedbooleanOptional

createInvoiceLinesPerTierbooleanOptional

estimatedUsageinteger · int32Optional

estimatedQuantityinteger · int32Optional

remainingQuantitynumber · double · nullableOptional

orderedQuantitynumber · double · nullableOptional

deliveryDatestring · date-time · nullableOptional

remarksstring · nullableOptional

accountsReceivableAccountstring · nullableOptional

deferredRevenueAccountstring · nullableOptional

recognizedRevenueAccountstring · nullableOptional

changeStateall ofOptional

string · enumOptionalPossible values:

displayPricenumber · double · nullableOptional

recurringMonthlyAmountnumber · double · nullableOptional

recurringMonthlyAmountBasenumber · double · nullableOptional

externalERPIdstring · nullableOptional

externalCRMIdstring · nullableOptional

pricenumber · double · nullableOptional

Price for active price detail. Only visible on charges created after 2025-05-14

listPricenumber · double · nullableOptional

List Price for active price detail. Only visible on charges created after 2025-05-14

discountAmountnumber · double · nullableOptional

Discount Amount for active price detail. Only visible on charges created after 2025-05-14

discountPercentagenumber · double · nullableOptional

Discount Percentage for active price detail. Only visible on charges created after 2025-05-14

totalPricenumber · double · nullableOptional

Only visible on charges created after 2025-05-14

totalListPricenumber · double · nullableOptional

Only visible on charges created after 2025-05-14

totalDiscountAmountnumber · double · nullableOptional

Only visible on charges created after 2025-05-14

totalDiscountPercentagenumber · double · nullableOptional

Only visible on charges created after 2025-05-14

totalPerInvoicenumber · double · nullableOptional

Total price for a whole billing period. Only visible on charges created after 2025-05-14

orderProductIdstring · uuidOptional

orderIdstring · uuidOptional

chargeIdstring · uuid · nullableOptional

Id of the charge used to create the order product charge. Not to be confused with field 'id'

createdstring · date-timeOptional

modifiedstring · date-timeOptional

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

404

Not Found

application/json

get

/Orders/Charges/{id}

HTTPcURLJavaScriptPython

GET /Orders/Charges/{id} HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "chargeNumber": "OPC-000001",
  "version": 1,
  "isLastVersion": true,
  "name": "text",
  "chargeType": "OneOff",
  "priceModel": "Flat",
  "effectiveStartDate": "2026-02-23T19:28:25.264Z",
  "effectiveEndDate": "2026-02-23T19:28:25.264Z",
  "quantity": 1,
  "unitCode": "text",
  "startOn": "AlignToSubscription",
  "endOn": "AlignToSubscription",
  "chargedThroughDate": "2026-02-23T19:28:25.264Z",
  "lastRenewalDate": "2026-02-23T19:28:25.264Z",
  "lastPriceAdjustmentDate": "2026-02-23T19:28:25.264Z",
  "pricePeriod": "Monthly",
  "usageRating": "Sum",
  "revenueRecognitionRule": "text",
  "billingDay": "None",
  "specificBillingDay": 1,
  "offsetBillingDays": 1,
  "billingPeriod": "Monthly",
  "billingTiming": "InAdvance",
  "periodAlignment": "None",
  "alignmentDate": "2026-02-23T19:28:25.264Z",
  "taxTemplate": "text",
  "taxIncluded": true,
  "createInvoiceLinesPerTier": true,
  "estimatedUsage": 1,
  "estimatedQuantity": 1,
  "remainingQuantity": 1,
  "orderedQuantity": 1,
  "deliveryDate": "2026-02-23T19:28:25.264Z",
  "remarks": "text",
  "accountsReceivableAccount": "text",
  "deferredRevenueAccount": "text",
  "recognizedRevenueAccount": "text",
  "changeState": "NotChanged",
  "displayPrice": 1,
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "priceDetails": [
    {
      "tier": 1,
      "price": 1,
      "listPrice": 1,
      "description": "text",
      "fromQuantity": 1,
      "toQuantity": 1,
      "priceBase": "Flat",
      "lineDiscountPercent": 1,
      "lineDiscountAmount": 1
    }
  ],
  "recurringMonthlyAmount": 1,
  "recurringMonthlyAmountBase": 1,
  "features": [
    {
      "code": "text",
      "description": "text"
    }
  ],
  "orderDiscounts": [
    {
      "orderDiscountId": "123e4567-e89b-12d3-a456-426614174000",
      "chargeId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "externalERPId": "text",
  "externalCRMId": "text",
  "cmrr": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-02-23T19:28:25.264Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "acv": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-02-23T19:28:25.264Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "tcv": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-02-23T19:28:25.264Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "emrr": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-02-23T19:28:25.264Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "oneTimeFees": {
    "amount": 1,
    "currencyCode": "text",
    "currencyConversionDate": "2026-02-23T19:28:25.264Z",
    "baseCurrencyAmount": 1,
    "baseCurrencyCode": "text"
  },
  "price": 1,
  "listPrice": 1,
  "discountAmount": 1,
  "discountPercentage": 1,
  "totalPrice": 1,
  "totalListPrice": 1,
  "totalDiscountAmount": 1,
  "totalDiscountPercentage": 1,
  "totalPerInvoice": 1,
  "orderProductId": "123e4567-e89b-12d3-a456-426614174000",
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "chargeId": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2026-02-23T19:28:25.264Z",
  "modified": "2026-02-23T19:28:25.264Z"
}

Update order product charge

patch

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

Body

application/merge-patch+json

Responses

200

Success

No content

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

patch

/Orders/Charges/{id}

HTTPcURLJavaScriptPython

PATCH /Orders/Charges/{id} HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 139

{
  "description": "text",
  "remarks": "text",
  "externalERPId": "text",
  "externalCRMId": "text",
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get Charges by order id

get

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Query parameters

FilterstringOptional

Filter the results. See developer resources for more information

Example: name eq 'Adam' and age gt 20

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-02-01

ModifiedBeforestring · date-timeOptional

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

Example: 2026-02-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

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

get

/Orders/{id}/charges

HTTPcURLJavaScriptPython

GET /Orders/{id}/charges HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "pageNumber": 1,
  "pageSize": 1,
  "totalPages": 1,
  "totalCount": 1,
  "nextPage": "https://example.com",
  "previousPage": "https://example.com",
  "firstPage": "https://example.com",
  "lastPage": "https://example.com",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "chargeNumber": "OPC-000001",
      "version": 1,
      "isLastVersion": true,
      "name": "text",
      "chargeType": "OneOff",
      "priceModel": "Flat",
      "effectiveStartDate": "2026-02-23T19:28:25.264Z",
      "effectiveEndDate": "2026-02-23T19:28:25.264Z",
      "quantity": 1,
      "unitCode": "text",
      "startOn": "AlignToSubscription",
      "endOn": "AlignToSubscription",
      "chargedThroughDate": "2026-02-23T19:28:25.264Z",
      "lastRenewalDate": "2026-02-23T19:28:25.264Z",
      "lastPriceAdjustmentDate": "2026-02-23T19:28:25.264Z",
      "pricePeriod": "Monthly",
      "usageRating": "Sum",
      "revenueRecognitionRule": "text",
      "billingDay": "None",
      "specificBillingDay": 1,
      "offsetBillingDays": 1,
      "billingPeriod": "Monthly",
      "billingTiming": "InAdvance",
      "periodAlignment": "None",
      "alignmentDate": "2026-02-23T19:28:25.264Z",
      "taxTemplate": "text",
      "taxIncluded": true,
      "createInvoiceLinesPerTier": true,
      "estimatedUsage": 1,
      "estimatedQuantity": 1,
      "remainingQuantity": 1,
      "orderedQuantity": 1,
      "deliveryDate": "2026-02-23T19:28:25.264Z",
      "remarks": "text",
      "accountsReceivableAccount": "text",
      "deferredRevenueAccount": "text",
      "recognizedRevenueAccount": "text",
      "changeState": "NotChanged",
      "displayPrice": 1,
      "customFields": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "priceDetails": [
        {
          "tier": 1,
          "price": 1,
          "listPrice": 1,
          "description": "text",
          "fromQuantity": 1,
          "toQuantity": 1,
          "priceBase": "Flat",
          "lineDiscountPercent": 1,
          "lineDiscountAmount": 1
        }
      ],
      "recurringMonthlyAmount": 1,
      "recurringMonthlyAmountBase": 1,
      "features": [
        {
          "code": "text",
          "description": "text"
        }
      ],
      "orderDiscounts": [
        {
          "orderDiscountId": "123e4567-e89b-12d3-a456-426614174000",
          "chargeId": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "externalERPId": "text",
      "externalCRMId": "text",
      "cmrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "acv": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "tcv": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "emrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "oneTimeFees": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "price": 1,
      "listPrice": 1,
      "discountAmount": 1,
      "discountPercentage": 1,
      "totalPrice": 1,
      "totalListPrice": 1,
      "totalDiscountAmount": 1,
      "totalDiscountPercentage": 1,
      "totalPerInvoice": 1,
      "orderProductId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "chargeId": "123e4567-e89b-12d3-a456-426614174000",
      "created": "2026-02-23T19:28:25.264Z",
      "modified": "2026-02-23T19:28:25.264Z"
    }
  ]
}

Get Charges by order product id

get

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Query parameters

FilterstringOptional

Filter the results. See developer resources for more information

Example: name eq 'Adam' and age gt 20

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-02-01

ModifiedBeforestring · date-timeOptional

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

Example: 2026-02-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

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

get

/Orders/Products/{id}/charges

HTTPcURLJavaScriptPython

GET /Orders/Products/{id}/charges HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "pageNumber": 1,
  "pageSize": 1,
  "totalPages": 1,
  "totalCount": 1,
  "nextPage": "https://example.com",
  "previousPage": "https://example.com",
  "firstPage": "https://example.com",
  "lastPage": "https://example.com",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "chargeNumber": "OPC-000001",
      "version": 1,
      "isLastVersion": true,
      "name": "text",
      "chargeType": "OneOff",
      "priceModel": "Flat",
      "effectiveStartDate": "2026-02-23T19:28:25.264Z",
      "effectiveEndDate": "2026-02-23T19:28:25.264Z",
      "quantity": 1,
      "unitCode": "text",
      "startOn": "AlignToSubscription",
      "endOn": "AlignToSubscription",
      "chargedThroughDate": "2026-02-23T19:28:25.264Z",
      "lastRenewalDate": "2026-02-23T19:28:25.264Z",
      "lastPriceAdjustmentDate": "2026-02-23T19:28:25.264Z",
      "pricePeriod": "Monthly",
      "usageRating": "Sum",
      "revenueRecognitionRule": "text",
      "billingDay": "None",
      "specificBillingDay": 1,
      "offsetBillingDays": 1,
      "billingPeriod": "Monthly",
      "billingTiming": "InAdvance",
      "periodAlignment": "None",
      "alignmentDate": "2026-02-23T19:28:25.264Z",
      "taxTemplate": "text",
      "taxIncluded": true,
      "createInvoiceLinesPerTier": true,
      "estimatedUsage": 1,
      "estimatedQuantity": 1,
      "remainingQuantity": 1,
      "orderedQuantity": 1,
      "deliveryDate": "2026-02-23T19:28:25.264Z",
      "remarks": "text",
      "accountsReceivableAccount": "text",
      "deferredRevenueAccount": "text",
      "recognizedRevenueAccount": "text",
      "changeState": "NotChanged",
      "displayPrice": 1,
      "customFields": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "priceDetails": [
        {
          "tier": 1,
          "price": 1,
          "listPrice": 1,
          "description": "text",
          "fromQuantity": 1,
          "toQuantity": 1,
          "priceBase": "Flat",
          "lineDiscountPercent": 1,
          "lineDiscountAmount": 1
        }
      ],
      "recurringMonthlyAmount": 1,
      "recurringMonthlyAmountBase": 1,
      "features": [
        {
          "code": "text",
          "description": "text"
        }
      ],
      "orderDiscounts": [
        {
          "orderDiscountId": "123e4567-e89b-12d3-a456-426614174000",
          "chargeId": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "externalERPId": "text",
      "externalCRMId": "text",
      "cmrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "acv": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "tcv": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "emrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "oneTimeFees": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-02-23T19:28:25.264Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "price": 1,
      "listPrice": 1,
      "discountAmount": 1,
      "discountPercentage": 1,
      "totalPrice": 1,
      "totalListPrice": 1,
      "totalDiscountAmount": 1,
      "totalDiscountPercentage": 1,
      "totalPerInvoice": 1,
      "orderProductId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "chargeId": "123e4567-e89b-12d3-a456-426614174000",
      "created": "2026-02-23T19:28:25.264Z",
      "modified": "2026-02-23T19:28:25.264Z"
    }
  ]
}

Edit InvoicedToDate on Charge

post

Set or edit invoiced to date on order product charge The Invoiced To date cannot be before the charges effective start date or the current invoiced to date. In the order product charge response the field for invoiced to date is referred to as 'chargedThroughDate'

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

younium-idempotency-keystringOptional

younium-idempotency-durationInHoursintegerOptional

Body

application/json

Responses

204

No Content

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

404

Not Found

application/json

post

/Orders/Charges/{id}/InvoicedTo

HTTPcURLJavaScriptPython

POST /Orders/Charges/{id}/InvoicedTo HTTP/1.1
Host: api.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "invoicedToDate": "2026-02-23T19:28:25.264Z"
}

No content

---