GraphQL API
Retrieve Upcoming Renewals
Query and sort SaaS license plans by upcoming contract-renewal date.
Last updated
Use licensePlans to retrieve plans whose contract-renewal dates fall inside a planning window.
Request
query UpcomingRenewals($from: Date!, $to: Date!, $first: Int!, $after: String) {
licensePlans(
first: $first
after: $after
where: {
contractDetails: {
renewal: {
upcomingDate: {
value: {
gte: $from
lte: $to
}
}
}
}
}
order: {
contractDetails: {
renewal: {
upcomingDate: {
value: ASC
}
}
}
}
) {
nodes {
id
name
integration {
id
name
}
contractDetails {
type
renewal {
upcomingDate {
value
origin
}
terminationPeriod {
value
origin
}
}
}
pricingStats {
annualCost
currency
potentialSaving {
amount
percentage
}
}
usageStats {
total
inUse {
total
}
unused {
total
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
Example variables for a 90-day planning window:
{
"from": "2026-08-01",
"to": "2026-10-31",
"first": 50,
"after": null
}
Plan the renewal
Use the renewal date together with terminationPeriod to calculate the practical decision deadline. Review pricing and usage before that deadline so procurement has time to validate seats, negotiate terms, or cancel.
The origin fields indicate where contract values came from. Treat manually entered and integrated data according to your organization’s data-quality process.