Subscriptions

get

Get subscription by id

Path parameters

idstring · uuidRequired

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

idstring · uuidOptional

createdstring · date-timeOptional

modifiedstring · date-time · nullableOptional

modifiedWithChildrenstring · date-time · nullableOptional

orderNumberstring · nullableRead-onlyOptional

versioninteger · int32Optional

lastVersionbooleanOptional

remarksstring · nullableOptional

statusstring · enumOptionalPossible values:

descriptionstring · nullableOptional

effectiveStartDatestring · dateOptional

effectiveEndDatestring · date · nullableOptional

effectiveChangeDatestring · date · nullableOptional

cancellationDatestring · date · nullableOptional

orderDatestring · date · nullableOptional

noticePeriodDatestring · date · nullableOptional

noticePeriodinteger · int32Optional

lastRenewalDatestring · date · nullableOptional

terminteger · int32Optional

renewalTerminteger · int32Optional

autoRenewedbooleanOptional

termTypestring · enumOptionalPossible values:

paymentMethodstring · enumOptionalPossible values:

yourReferencestring · nullableOptional

invoiceSeparatelybooleanOptional

ourReferencestring · nullableOptional

yourOrderNumberstring · nullableOptional

buyerReferencestring · nullableOptional

billingPeriodstring · enumOptionalPossible values:

setBillingPeriodbooleanOptional

paymentTermstring · nullableOptional

useAccountInvoiceBatchGroupbooleanOptional

currencystring · nullableOptional

externalCRMIdstring · nullableOptional

externalERPIdstring · nullableOptional

invoiceCurrencystring · nullableOptional

productsstring · nullableOptional

milestonesstring · nullableOptional

discountsstring · nullableOptional

metricsstring · nullableOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

404

Not Found

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions/{id}

HTTPcURLJavaScriptPython

GET /subscriptions/{id} HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2026-02-23T21:19:57.757Z",
  "modified": "2026-02-23T21:19:57.757Z",
  "modifiedWithChildren": "2026-02-23T21:19:57.757Z",
  "orderNumber": "text",
  "version": 1,
  "lastVersion": true,
  "remarks": "text",
  "status": "Draft",
  "description": "text",
  "effectiveStartDate": "2026-02-23",
  "effectiveEndDate": "2026-02-23",
  "effectiveChangeDate": "2026-02-23",
  "cancellationDate": "2026-02-23",
  "orderDate": "2026-02-23",
  "noticePeriodDate": "2026-02-23",
  "noticePeriod": 1,
  "lastRenewalDate": "2026-02-23",
  "term": 1,
  "renewalTerm": 1,
  "autoRenewed": true,
  "termType": "Termed",
  "paymentMethod": "Invoice",
  "yourReference": "text",
  "invoiceSeparately": true,
  "ourReference": "text",
  "yourOrderNumber": "text",
  "buyerReference": "text",
  "billingPeriod": "Monthly",
  "setBillingPeriod": true,
  "paymentTerm": "text",
  "useAccountInvoiceBatchGroup": true,
  "currency": "text",
  "externalCRMId": "text",
  "externalERPId": "text",
  "invoiceCurrency": "text",
  "invoiceAddress": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "name": "text",
    "street": "text",
    "street2": "text",
    "city": "text",
    "county": "text",
    "state": "text",
    "zip": "text",
    "country": "text"
  },
  "deliveryAddress": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "name": "text",
    "street": "text",
    "street2": "text",
    "city": "text",
    "county": "text",
    "state": "text",
    "zip": "text",
    "country": "text"
  },
  "account": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "accountNumber": "text",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "invoiceAccount": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "accountNumber": "text",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "invoiceBatchGroup": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "code": "text",
    "description": "text"
  },
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "products": "text",
  "milestones": "text",
  "discounts": "text",
  "metrics": "text"
}

get

Get subscription by order number

Path parameters

orderNumberstringRequired

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

idstring · uuidOptional

createdstring · date-timeOptional

modifiedstring · date-time · nullableOptional

modifiedWithChildrenstring · date-time · nullableOptional

orderNumberstring · nullableRead-onlyOptional

versioninteger · int32Optional

lastVersionbooleanOptional

remarksstring · nullableOptional

statusstring · enumOptionalPossible values:

descriptionstring · nullableOptional

effectiveStartDatestring · dateOptional

effectiveEndDatestring · date · nullableOptional

effectiveChangeDatestring · date · nullableOptional

cancellationDatestring · date · nullableOptional

orderDatestring · date · nullableOptional

noticePeriodDatestring · date · nullableOptional

noticePeriodinteger · int32Optional

lastRenewalDatestring · date · nullableOptional

terminteger · int32Optional

renewalTerminteger · int32Optional

autoRenewedbooleanOptional

termTypestring · enumOptionalPossible values:

paymentMethodstring · enumOptionalPossible values:

yourReferencestring · nullableOptional

invoiceSeparatelybooleanOptional

ourReferencestring · nullableOptional

yourOrderNumberstring · nullableOptional

buyerReferencestring · nullableOptional

billingPeriodstring · enumOptionalPossible values:

setBillingPeriodbooleanOptional

paymentTermstring · nullableOptional

useAccountInvoiceBatchGroupbooleanOptional

currencystring · nullableOptional

externalCRMIdstring · nullableOptional

externalERPIdstring · nullableOptional

invoiceCurrencystring · nullableOptional

productsstring · nullableOptional

milestonesstring · nullableOptional

discountsstring · nullableOptional

metricsstring · nullableOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

404

Not Found

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions/{orderNumber}

HTTPcURLJavaScriptPython

GET /subscriptions/{orderNumber} HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2026-02-23T21:19:57.757Z",
  "modified": "2026-02-23T21:19:57.757Z",
  "modifiedWithChildren": "2026-02-23T21:19:57.757Z",
  "orderNumber": "text",
  "version": 1,
  "lastVersion": true,
  "remarks": "text",
  "status": "Draft",
  "description": "text",
  "effectiveStartDate": "2026-02-23",
  "effectiveEndDate": "2026-02-23",
  "effectiveChangeDate": "2026-02-23",
  "cancellationDate": "2026-02-23",
  "orderDate": "2026-02-23",
  "noticePeriodDate": "2026-02-23",
  "noticePeriod": 1,
  "lastRenewalDate": "2026-02-23",
  "term": 1,
  "renewalTerm": 1,
  "autoRenewed": true,
  "termType": "Termed",
  "paymentMethod": "Invoice",
  "yourReference": "text",
  "invoiceSeparately": true,
  "ourReference": "text",
  "yourOrderNumber": "text",
  "buyerReference": "text",
  "billingPeriod": "Monthly",
  "setBillingPeriod": true,
  "paymentTerm": "text",
  "useAccountInvoiceBatchGroup": true,
  "currency": "text",
  "externalCRMId": "text",
  "externalERPId": "text",
  "invoiceCurrency": "text",
  "invoiceAddress": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "name": "text",
    "street": "text",
    "street2": "text",
    "city": "text",
    "county": "text",
    "state": "text",
    "zip": "text",
    "country": "text"
  },
  "deliveryAddress": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "name": "text",
    "street": "text",
    "street2": "text",
    "city": "text",
    "county": "text",
    "state": "text",
    "zip": "text",
    "country": "text"
  },
  "account": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "accountNumber": "text",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "invoiceAccount": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "accountNumber": "text",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "invoiceBatchGroup": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "code": "text",
    "description": "text"
  },
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "products": "text",
  "milestones": "text",
  "discounts": "text",
  "metrics": "text"
}

get

Get metrics by subscription id

Path parameters

idstring · uuidRequired

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

baseCurrencyCodestring · nullableOptional

currencyConversionDatestring · date-time · nullableOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

404

Not Found

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions/{id}/metrics

HTTPcURLJavaScriptPython

GET /subscriptions/{id}/metrics HTTP/1.1
Accept: */*

{
  "baseCurrencyCode": "text",
  "currencyConversionDate": "2026-02-23T21:19:57.757Z",
  "cmrr": {
    "amount": 1,
    "currency": "text",
    "baseCurrencyAmount": 1
  },
  "emrr": {
    "amount": 1,
    "currency": "text",
    "baseCurrencyAmount": 1
  },
  "carr": {
    "amount": 1,
    "currency": "text",
    "baseCurrencyAmount": 1
  },
  "oneTimeFees": {
    "amount": 1,
    "currency": "text",
    "baseCurrencyAmount": 1
  },
  "tcv": {
    "amount": 1,
    "currency": "text",
    "baseCurrencyAmount": 1
  }
}

get

Get subscriptions

Query parameters

subscriptionModifiedAfterstring · date-timeRequired

subscriptionModifiedBeforestring · date-timeRequired

pageSizeinteger · int32Optional

pageNumberinteger · int32Optional

statusstring · enumOptionalPossible values:

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

nextPagestring · nullableRead-onlyOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions

HTTPcURLJavaScriptPython

GET /subscriptions?subscriptionModifiedAfter=2026-02-23T21%3A19%3A57.757Z&subscriptionModifiedBefore=2026-02-23T21%3A19%3A57.757Z HTTP/1.1
Accept: */*

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created": "2026-02-23T21:19:57.757Z",
      "modified": "2026-02-23T21:19:57.757Z",
      "modifiedWithChildren": "2026-02-23T21:19:57.757Z",
      "orderNumber": "text",
      "version": 1,
      "lastVersion": true,
      "remarks": "text",
      "status": "Draft",
      "description": "text",
      "effectiveStartDate": "2026-02-23",
      "effectiveEndDate": "2026-02-23",
      "effectiveChangeDate": "2026-02-23",
      "cancellationDate": "2026-02-23",
      "orderDate": "2026-02-23",
      "noticePeriodDate": "2026-02-23",
      "noticePeriod": 1,
      "lastRenewalDate": "2026-02-23",
      "term": 1,
      "renewalTerm": 1,
      "autoRenewed": true,
      "termType": "Termed",
      "paymentMethod": "Invoice",
      "yourReference": "text",
      "invoiceSeparately": true,
      "ourReference": "text",
      "yourOrderNumber": "text",
      "buyerReference": "text",
      "billingPeriod": "Monthly",
      "setBillingPeriod": true,
      "paymentTerm": "text",
      "useAccountInvoiceBatchGroup": true,
      "currency": "text",
      "externalCRMId": "text",
      "externalERPId": "text",
      "invoiceCurrency": "text",
      "invoiceAddress": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "description": "text",
        "name": "text",
        "street": "text",
        "street2": "text",
        "city": "text",
        "county": "text",
        "state": "text",
        "zip": "text",
        "country": "text"
      },
      "deliveryAddress": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "description": "text",
        "name": "text",
        "street": "text",
        "street2": "text",
        "city": "text",
        "county": "text",
        "state": "text",
        "zip": "text",
        "country": "text"
      },
      "account": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "accountNumber": "text",
        "externalERPId": "text",
        "externalCRMId": "text"
      },
      "invoiceAccount": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "accountNumber": "text",
        "externalERPId": "text",
        "externalCRMId": "text"
      },
      "invoiceBatchGroup": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "code": "text",
        "description": "text"
      },
      "customFields": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "products": "text",
      "milestones": "text",
      "discounts": "text",
      "metrics": "text"
    }
  ],
  "nextPage": "text"
}

get

Get subscription products by subscription id

Path parameters

idstring · uuidRequired

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

idstring · uuidOptional

createdstring · date-timeOptional

modifiedstring · date-time · nullableOptional

modifiedWithChildrenstring · date-time · nullableOptional

orderIdstring · uuid · nullableOptional

productNumberstring · nullableOptional

chargePlanIdstring · uuid · nullableOptional

chargePlanNamestring · nullableOptional

chargePlanNumberstring · nullableOptional

lineNumberinteger · int32Optional

namestring · nullableOptional

externalERPIdstring · nullableOptional

externalCRMIdstring · nullableOptional

chargesstring · nullableOptional

metricsstring · nullableOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

404

Not Found

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions/{id}/subscription-products

HTTPcURLJavaScriptPython

GET /subscriptions/{id}/subscription-products HTTP/1.1
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "created": "2026-02-23T21:19:57.757Z",
    "modified": "2026-02-23T21:19:57.757Z",
    "modifiedWithChildren": "2026-02-23T21:19:57.757Z",
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "productNumber": "text",
    "chargePlanId": "123e4567-e89b-12d3-a456-426614174000",
    "chargePlanName": "text",
    "chargePlanNumber": "text",
    "lineNumber": 1,
    "name": "text",
    "externalERPId": "text",
    "externalCRMId": "text",
    "customFields": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "charges": "text",
    "metrics": "text"
  }
]

get

Get milestones by subscription id

Path parameters

idstring · uuidRequired

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

idstring · uuidOptional

namestring · nullableOptional

descriptionstring · nullableOptional

milestoneDatestring · date · nullableOptional

plannedDatestring · date · nullableOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

404

Not Found

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions/{id}/milestones

HTTPcURLJavaScriptPython

GET /subscriptions/{id}/milestones HTTP/1.1
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "milestoneDate": "2026-02-23",
    "plannedDate": "2026-02-23"
  }
]

get

Get discounts by subscription id

Path parameters

idstring · uuidRequired

Header parameters

AuthorizationanyRequired

Legal-EntityanyRequired

Responses

200

OK

application/json

idstring · uuidOptional

startOnstring · enumOptionalPossible values:

endOnstring · enumOptionalPossible values:

startDatestring · date · nullableOptional

endDatestring · date · nullableOptional

percentnumber · double · nullableOptional

discountTypestring · enumOptionalPossible values:

onlySelectedChargesbooleanOptional

400

Bad Request

application/problem+json

403

Forbidden

application/problem+json

404

Not Found

application/problem+json

500

Internal Server Error

application/problem+json

get

/subscriptions/{id}/discounts

HTTPcURLJavaScriptPython

GET /subscriptions/{id}/discounts HTTP/1.1
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "startOn": "AlignToOrder",
    "endOn": "AlignToOrder",
    "startDate": "2026-02-23",
    "endDate": "2026-02-23",
    "percent": 1,
    "discountType": "Percent",
    "onlySelectedCharges": true
  }
]

---