Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

getEntitlementByActivationId

(activationId)

Fetches an Entitlement associated to the given Activation ID

Arguments

activationId
String!,non-nullrequired

Return type

Entitlement
createdOn
String

Represents the date and time when the entitlement was created

description
String

Human readable description of the entitlement

entitlementId
String!,non-null

Represents a high-level entitlement entity

shipToAddress
String

Represents the shipping address associated with the entitlement

shipToEmail
String

Email address associated with shipment contact

status
String

status could be one of the following values: ACTIVE, INACTIVE, DRAFT, DEPLOYED, OBSOLETE

updatedOn
String

Represents the date and time when the entitlement was last updated

Query sample
query getEntitlementByActivationId($activationId: String!) {
  getEntitlementByActivationId(activationId: $activationId) {
    createdOn 
    description 
    entitlementId 
    shipToAddress 
    shipToEmail 
    status 
    updatedOn 
  }
}
Variables
{ "activationId": "Example String" }
Response sample
{ "data": { "createdOn": "Example String", "description": "Example String", "entitlementId": "Example String", "shipToAddress": "Example String", "shipToEmail": "Example String", "status": "Example String", "updatedOn": "Example String" } }

getEntitlementById

(entitlementId)

Fetches an Entitlement by its ID

Arguments

entitlementId
String!,non-nullrequired

Return type

EntitlementDetail
accounts
[Account!]!,non-null

Represents the accounts associated with the entitlement

attributes

Represents the custom attributes associated with the entitlement

createdOn
String

Represents the date and time when the entitlement was created

description
String

Human readable description of the entitlement

entitlementId
String!,non-null

Unique identifier of the entitlement

lineItems

List of line items associated with the entitlement

shipToAddress
String

Represents the shipping address associated with the entitlement

shipToEmail
String

Email address associated with shipment contact

status
String

status could be one of the following values: ACTIVE, INACTIVE, DRAFT, DEPLOYED, OBSOLETE

updatedOn
String

Represents the date and time when the entitlement was last updated

Query sample
query getEntitlementById($entitlementId: String!) {
  getEntitlementById(entitlementId: $entitlementId) {
    accounts {
      __typename
      # ...AccountFragment
    }
    attributes {
      __typename
      # ...AttributeFragment
    }
    createdOn 
    description 
    entitlementId 
    lineItems {
      __typename
      # ...LineItemDetailFragment
    }
    shipToAddress 
    shipToEmail 
    status 
    updatedOn 
  }
}
Variables
{ "entitlementId": "Example String" }
Response sample
{ "data": { "accounts": [ { "__typename": "Account" } ], "attributes": [ { "__typename": "Attribute" } ], "createdOn": "Example String", "description": "Example String", "entitlementId": "Example String", "lineItems": [ { "__typename": "LineItemDetail" } ], "shipToAddress": "Example String", "shipToEmail": "Example String", "status": "Example String", "updatedOn": "Example String" } }

getEntitlements

(...args)

Fetches a list of Entitlements based on various filters

Arguments

accountId
String

Unique identifier for the account

accountName
String

Name of the account

contactEmail
String

Contact email associated with the entitlement

limit
Int

limit number of records per page

page
Int

page number for pagination

partNumber
String

Product Part number associated with the entitlement

product
String

Product associated with the entitlement

productVersion
String

Product version associated with the entitlement

sortBy
String

sortBy - You can sort by the following fields entitlement_id,account_name,created_on

sortOrder
String

sortOrder - You can specify either asc or desc

status
String

status - You can filter by the following statuses active, inactive, draft, deployed, obsolete

Return type

EntitlementListResponse
entitlements

List of entitlement entities

limit
Int

Represents limit per page for pagination

page
Int

Represents page for pagination

Query sample
query getEntitlements(
  $accountId: String
  $accountName: String
  $contactEmail: String
  $limit: Int
  $page: Int
  $partNumber: String
  $product: String
  $productVersion: String
  $sortBy: String
  $sortOrder: String
  $status: String
) {
  getEntitlements(
    accountId: $accountId
    accountName: $accountName
    contactEmail: $contactEmail
    limit: $limit
    page: $page
    partNumber: $partNumber
    product: $product
    productVersion: $productVersion
    sortBy: $sortBy
    sortOrder: $sortOrder
    status: $status
  ) {
    entitlements {
      __typename
      # ...EntitlementFragment
    }
    limit 
    page 
  }
}
Variables
{ "accountId": "Example String", "accountName": "Example String", "contactEmail": "Example String", "limit": 40, "page": 40, "partNumber": "Example String", "product": "Example String", "productVersion": "Example String", "sortBy": "Example String", "sortOrder": "Example String", "status": "Example String" }
Response sample
{ "data": { "entitlements": [ { "__typename": "Entitlement" } ], "limit": 40, "page": 40 } }

getLineItemsForEntitlement

(...args)

Given an entitlement ID, fetch the line items associated with it

Arguments

activationId
String

Activation ID of the line item

entitlementId
String!,non-nullrequired

Entitlement ID for which line items are to be fetched

licenseModelName
String

License model name associated with the line item

limit
Int

limit number of records per page

page
Int

page number for pagination

productName
String

Name of the product associated with the line item

startDate
String

Start date of the line item

status
String

Status of the line item. You can filter by the following statuses active, inactive, draft, deployed, obsolete

Return type

LineItemListResponse
limit
Int

Represents limit per page for pagination

lineItems
[LineItem!]!,non-null

List of line item entities

page
Int

Represents page for pagination

Query sample
query getLineItemsForEntitlement(
  $activationId: String
  $entitlementId: String!
  $licenseModelName: String
  $limit: Int
  $page: Int
  $productName: String
  $startDate: String
  $status: String
) {
  getLineItemsForEntitlement(
    activationId: $activationId
    entitlementId: $entitlementId
    licenseModelName: $licenseModelName
    limit: $limit
    page: $page
    productName: $productName
    startDate: $startDate
    status: $status
  ) {
    limit 
    lineItems {
      __typename
      # ...LineItemFragment
    }
    page 
  }
}
Variables
{ "activationId": "Example String", "entitlementId": "Example String", "licenseModelName": "Example String", "limit": 40, "page": 40, "productName": "Example String", "startDate": "Example String", "status": "Example String" }
Response sample
{ "data": { "limit": 40, "lineItems": [ { "__typename": "LineItem" } ], "page": 40 } }

getFeatureBundle

(featureBundleName)

Get a specific feature bundle by its name.

Arguments

featureBundleName
String!,non-nullrequired

Name of the feature bundle. Example: "MyFeatureBundle"

Return type

FeatureBundleGetResponse
featureBundle

The feature bundle details

Query sample
query getFeatureBundle($featureBundleName: String!) {
  getFeatureBundle(featureBundleName: $featureBundleName) {
    featureBundle {
      __typename
      # ...FeatureBundleGetFragment
    }
  }
}
Variables
{ "featureBundleName": "Example String" }
Response sample
{ "data": { "featureBundle": { "__typename": "FeatureBundleGet" } } }

getFeatureBundles

(...args)

Get feature bundles with filtering and pagination support. Filters can be applied on featureBundleName, state, creationDate, and lastModifiedDate.

Arguments

creationDate
String

Filter by creation date in ISO 8601 format. Example: "2024-01-15"

featureBundleName
String

Filter by feature bundle name. Example: "MyFeatureBundle"

lastModifiedDate
String

Filter by last modified date in ISO 8601 format. Example: "2024-01-20"

limit
Int

Number of records per page. Default: 25

page
Int

Requested page number for pagination. Default: 1

state
String

Filter by feature bundle state. Valid values: DRAFT, DEPLOYED, OBSOLETE, INACTIVE. Example: "DEPLOYED"

Return type

FeatureBundleListResponse

List of feature bundles

pagination

Pagination information

Query sample
query getFeatureBundles(
  $creationDate: String
  $featureBundleName: String
  $lastModifiedDate: String
  $limit: Int
  $page: Int
  $state: String
) {
  getFeatureBundles(
    creationDate: $creationDate
    featureBundleName: $featureBundleName
    lastModifiedDate: $lastModifiedDate
    limit: $limit
    page: $page
    state: $state
  ) {
    featureBundles {
      __typename
      # ...FeatureBundleResponseDTOFragment
    }
    pagination {
      __typename
      # ...PaginationFragment
    }
  }
}
Variables
{ "creationDate": "Example String", "featureBundleName": "Example String", "lastModifiedDate": "Example String", "limit": 40, "page": 40, "state": "Example String" }
Response sample
{ "data": { "featureBundles": [ { "__typename": "FeatureBundleResponseDTO" } ], "pagination": { "__typename": "Pagination" } } }

getFeatures

(...args)

Get features with filtering and pagination support. Filters can be applied on name, version, versionFormat, state, creationDate, lastModifiedDate, and vendorAuthString.

Arguments

creationDate
String

Filter by creation date in ISO 8601 format. Example: "2024-01-15"

lastModifiedDate
String

Filter by last modified date in ISO 8601 format. Example: "2024-01-20"

limit
Int

Number of records per page. Default: 25

name
String

Filter feature by name. Example: "MyFeature"

page
Int

Requested page number for pagination. Default: 1

state
String

Feature state (e.g., DRAFT, DEPLOYED). Valid values: DRAFT, DEPLOYED, OBSOLETE, INACTIVE. Example: "DEPLOYED"

vendorAuthString
String

Vendor authorization string for filtering.

version
String

Filter feature by version. Example: "1.0"

versionFormat
String

Filter feature by versionFormat. Valid values: FIXED, DATEBASED. Example: "FIXED"

Return type

PagedFeatureResponse

List of features

pagination

Pagination information

Query sample
query getFeatures(
  $creationDate: String
  $lastModifiedDate: String
  $limit: Int
  $name: String
  $page: Int
  $state: String
  $vendorAuthString: String
  $version: String
  $versionFormat: String
) {
  getFeatures(
    creationDate: $creationDate
    lastModifiedDate: $lastModifiedDate
    limit: $limit
    name: $name
    page: $page
    state: $state
    vendorAuthString: $vendorAuthString
    version: $version
    versionFormat: $versionFormat
  ) {
    features {
      __typename
      # ...FeaturesResponseDTOFragment
    }
    pagination {
      __typename
      # ...PaginationFragment
    }
  }
}
Variables
{ "creationDate": "Example String", "lastModifiedDate": "Example String", "limit": 40, "name": "Example String", "page": 40, "state": "Example String", "vendorAuthString": "Example String", "version": "Example String", "versionFormat": "Example String" }
Response sample
{ "data": { "features": [ { "__typename": "FeaturesResponseDTO" } ], "pagination": { "__typename": "Pagination" } } }

getMaintenanceProducts

(...args)

Get maintenance products with filtering, sorting, and pagination support. Filters can be applied on maintenanceName, version, partNumber, state, creationDate, and lastModifiedDate.

Arguments

creationDate
String

Filter by creation date (ISO 8601 format). Example: "2023-10-15T10:30:00Z"

lastModifiedDate
String

Filter by last modified date (ISO 8601 format). Example: "2023-11-20T14:45:00Z"

limit
Int

Number of records per page. Default: 25

maintenanceName
String

Filter by maintenance product name. Example: "MyMaintenanceProduct"

page
Int

Requested page number for pagination. Default: 1

partNumber
String

Filter by part number. Example: "PN-12345"

sort_by
String

Field to sort by. Valid values: maintenanceName, state, partNumber, version, creationDate, lastModifiedDate. Example: "maintenanceName"

sort_order
String

Order to sort by. Valid values: asc, desc. Example: "asc"

state
String

Filter by maintenance product state. Valid values: DRAFT, DEPLOYED, OBSOLETE, INACTIVE. Example: "DEPLOYED"

version
String

Filter by maintenance product version. Example: "1.0"

Return type

MaintenanceProductListDTO
maintenanceProducts

List of maintenance products

pagination

Pagination information

Query sample
query getMaintenanceProducts(
  $creationDate: String
  $lastModifiedDate: String
  $limit: Int
  $maintenanceName: String
  $page: Int
  $partNumber: String
  $sort_by: String
  $sort_order: String
  $state: String
  $version: String
) {
  getMaintenanceProducts(
    creationDate: $creationDate
    lastModifiedDate: $lastModifiedDate
    limit: $limit
    maintenanceName: $maintenanceName
    page: $page
    partNumber: $partNumber
    sort_by: $sort_by
    sort_order: $sort_order
    state: $state
    version: $version
  ) {
    maintenanceProducts {
      __typename
      # ...MaintenanceProductDTOFragment
    }
    pagination {
      __typename
      # ...PaginationFragment
    }
  }
}
Variables
{ "creationDate": "Example String", "lastModifiedDate": "Example String", "limit": 40, "maintenanceName": "Example String", "page": 40, "partNumber": "Example String", "sort_by": "Example String", "sort_order": "Example String", "state": "Example String", "version": "Example String" }
Response sample
{ "data": { "maintenanceProducts": [ { "__typename": "MaintenanceProductDTO" } ], "pagination": { "__typename": "Pagination" } } }

getPartNumbers

(...args)

Get part numbers with filtering, sorting, and pagination support. Filters can be applied on partNumber, productName, licenseModel, dates, and mapping status.

Arguments

creationDate
String

Filter by creation date in ISO 8601 format. Example: "2024-01-15"

lastModifiedDate
String

Filter by last modified date in ISO 8601 format. Example: "2024-01-20"

licenseModel
String

Filter by license model. Example: "LicenseModelName"

limit
Int

Number of records per page. Default: 25

page
Int

Requested page number for pagination. Default: 1

partNumber
String

Filter by part number name. Example: "MyPartNumber"

productName
String

Filter by product name. Example: "SampleProduct"

sort_by
String

Field to sort by. Valid values: partNumber, productName, licenseModel, creationDate, lastModifiedDate. Example: "partNumber"

sort_order
String

Order to sort by. Valid values: asc, desc. Default: asc.

unmappedWithLicenseModel
Boolean

Filter by unmapped with license model. Example: false.

unmappedWithProduct
Boolean

Filter by unmapped with product. Example: true.

Return type

PartNumberResponseListDTO
pagination

Pagination information

List of part numbers

Query sample
query getPartNumbers(
  $creationDate: String
  $lastModifiedDate: String
  $licenseModel: String
  $limit: Int
  $page: Int
  $partNumber: String
  $productName: String
  $sort_by: String
  $sort_order: String
  $unmappedWithLicenseModel: Boolean
  $unmappedWithProduct: Boolean
) {
  getPartNumbers(
    creationDate: $creationDate
    lastModifiedDate: $lastModifiedDate
    licenseModel: $licenseModel
    limit: $limit
    page: $page
    partNumber: $partNumber
    productName: $productName
    sort_by: $sort_by
    sort_order: $sort_order
    unmappedWithLicenseModel: $unmappedWithLicenseModel
    unmappedWithProduct: $unmappedWithProduct
  ) {
    pagination {
      __typename
      # ...PaginationFragment
    }
    partNumbers {
      __typename
      # ...PartNumberResponseDTOFragment
    }
  }
}
Variables
{ "creationDate": "Example String", "lastModifiedDate": "Example String", "licenseModel": "Example String", "limit": 40, "page": 40, "partNumber": "Example String", "productName": "Example String", "sort_by": "Example String", "sort_order": "Example String", "unmappedWithLicenseModel": true, "unmappedWithProduct": true }
Response sample
{ "data": { "pagination": { "__typename": "Pagination" }, "partNumbers": [ { "__typename": "PartNumberResponseDTO" } ] } }

getProducts

(...args)

Fetches a list of Products based on various filters

Arguments

description
String

Filter by description

hostType
String

Filter by host type

licenseTechnology
String

Filter by license technology

limit
Int

Number of records per page

page
Int

Requested page number

partNumber
String

Filter by part number

productId
ID

Filter by product ID

productName
String

Filter by product name

sortBy
String

Field to sort by (productName,state,partNumber,hosttype,licenseTechnology,version,usedOnDevice)

sortOrder
String

Order to sort by (asc/desc)

state
String

Filter by product state

usedOnDevice
String

Filter by used on device

version
String

Filter by product version

Return type

ProductListDTO
pagination

Represents pagination information

productList

List of product entities

Query sample
query getProducts(
  $description: String
  $hostType: String
  $licenseTechnology: String
  $limit: Int
  $page: Int
  $partNumber: String
  $productId: ID
  $productName: String
  $sortBy: String
  $sortOrder: String
  $state: String
  $usedOnDevice: String
  $version: String
) {
  getProducts(
    description: $description
    hostType: $hostType
    licenseTechnology: $licenseTechnology
    limit: $limit
    page: $page
    partNumber: $partNumber
    productId: $productId
    productName: $productName
    sortBy: $sortBy
    sortOrder: $sortOrder
    state: $state
    usedOnDevice: $usedOnDevice
    version: $version
  ) {
    pagination {
      __typename
      # ...PaginationFragment
    }
    productList {
      __typename
      # ...ProductFragment
    }
  }
}
Variables
{ "description": "Example String", "hostType": "Example String", "licenseTechnology": "Example String", "limit": 40, "page": 40, "partNumber": "Example String", "productId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "productName": "Example String", "sortBy": "Example String", "sortOrder": "Example String", "state": "Example String", "usedOnDevice": "Example String", "version": "Example String" }
Response sample
{ "data": { "pagination": { "__typename": "Pagination" }, "productList": [ { "__typename": "Product" } ] } }

Mutations

Overview

Objects

Overview

Inputs

Overview

Scalars

Overview